<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.7">
+<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family: serif; font-weight: normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<h1 class="settitle">NTP Configuration File User's Manual</h1>
<div class="node">
+<a name="Top"></a>
<p><hr>
-
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntp_002econf-Description">ntp.conf Description</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>
</ul>
<div class="node">
+<a name="ntp.conf-Description"></a>
+<a name="ntp_002econf-Description"></a>
<p><hr>
-
<a name="ntp_002econf-Description"></a>Previous: <a rel="previous" accesskey="p" href="#Top">Top</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">
-<p><hr>
+<a name="ntp.conf-Notes"></a>
<a name="ntp_002econf-Notes"></a>
-<br>
+<p><hr>
+
+
</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
-<span class="file">/etc</span>
+<samp><span class="file">/etc</span></samp>
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
-<span class="file">/usr/share/doc/ntp</span>)
+<samp><span class="file">/usr/share/doc/ntp</span></samp>)
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">
-<p><hr>
<a name="Configuration-Support"></a>
-<br>
+<p><hr>
+
+
</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
-<span class="file">/usr/share/doc/ntp</span>).
+<samp><span class="file">/usr/share/doc/ntp</span></samp>).
<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
-<span class="file">/usr/share/doc/ntp</span>)
+<samp><span class="file">/usr/share/doc/ntp</span></samp>)
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">
-<p><hr>
<a name="Authentication-Support"></a>
-<br>
+<p><hr>
+
+
</div>
<h4 class="subsection">Authentication Support</h4>
Keys and
related information are specified in a key
file, usually called
-<span class="file">ntp.keys</span>,
+<samp><span class="file">ntp.keys</span></samp>,
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
-<span class="file">/usr/local/etc</span>.
+<samp><span class="file">/usr/local/etc</span></samp>.
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
-<span class="file">ntpkey_cert_</span><kbd>hostname</kbd>
+<samp><span class="file">ntpkey_cert_</span></samp><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
-<span class="file">ntpkey_gq_</span><kbd>hostname</kbd>
+<samp><span class="file">ntpkey_gq_</span></samp><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
-<span class="file">ntpkey_key_</span><kbd>hostname</kbd>
+<samp><span class="file">ntpkey_key_</span></samp><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
-<span class="file">ntpkey_iff_</span><kbd>hostname</kbd>
+<samp><span class="file">ntpkey_iff_</span></samp><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
-<span class="file">ntpkey_leap</span>
+<samp><span class="file">ntpkey_leap</span></samp>
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
-<span class="file">ntpkey_mv_</span><kbd>hostname</kbd>
+<samp><span class="file">ntpkey_mv_</span></samp><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
-<span class="file">ntpkey_sign_</span><kbd>hostname</kbd>
+<samp><span class="file">ntpkey_sign_</span></samp><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
-<span class="file">/usr/local/etc/</span>.
+<samp><span class="file">/usr/local/etc/</span></samp>.
<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">
-<p><hr>
<a name="Monitoring-Support"></a>
-<br>
+<p><hr>
+
+
</div>
<h4 class="subsection">Monitoring Support</h4>
supported.
Statistic files are managed using file generation sets
and scripts in the
-<span class="file">./scripts</span>
+<samp><span class="file">./scripts</span></samp>
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
-<span class="file">..</span>
+<samp><span class="file">..</span></samp>
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">
-<p><hr>
<a name="Access-Control-Support"></a>
-<br>
+<p><hr>
+
+
</div>
<h4 class="subsection">Access Control Support</h4>
page
(available as part of the HTML documentation
provided in
-<span class="file">/usr/share/doc/ntp</span>).
+<samp><span class="file">/usr/share/doc/ntp</span></samp>).
<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
-<span class="file">ntp.keys</span>
+<samp><span class="file">ntp.keys</span></samp>
file.
This restriction is not enabled by default,
to maintain backward compatability.
NTP server is unrestricted).
</dl>
<div class="node">
-<p><hr>
<a name="Automatic-NTP-Configuration-Options"></a>
-<br>
+<p><hr>
+
+
</div>
<h4 class="subsection">Automatic NTP Configuration Options</h4>
multiples of 32 starting at 31.
</dl>
<div class="node">
-<p><hr>
<a name="Reference-Clock-Support"></a>
-<br>
+<p><hr>
+
+
</div>
<h4 class="subsection">Reference Clock Support</h4>
page
(available as part of the HTML documentation
provided in
-<span class="file">/usr/share/doc/ntp</span>).
+<samp><span class="file">/usr/share/doc/ntp</span></samp>).
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
-<span class="file">/usr/share/doc/ntp</span>).
+<samp><span class="file">/usr/share/doc/ntp</span></samp>).
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
-<span class="file">/usr/share/doc/ntp</span>).
+<samp><span class="file">/usr/share/doc/ntp</span></samp>).
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
-<span class="file">/usr/share/doc/ntp</span>).
+<samp><span class="file">/usr/share/doc/ntp</span></samp>).
<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
-<span class="file">/usr/share/doc/ntp</span>)
+<samp><span class="file">/usr/share/doc/ntp</span></samp>)
page.
The
<code>minpoll</code>
page
(available as part of the HTML documentation
provided in
-<span class="file">/usr/share/doc/ntp</span>)
+<samp><span class="file">/usr/share/doc/ntp</span></samp>)
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
-<span class="file">/usr/share/doc/ntp</span>).
+<samp><span class="file">/usr/share/doc/ntp</span></samp>).
<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
-<span class="file">/usr/share/doc/ntp</span> <span class="file">).</span>
+<samp><span class="file">/usr/share/doc/ntp</span></samp> <samp><span class="file">).</span></samp>
<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">
-<p><hr>
<a name="Miscellaneous-Options"></a>
-<br>
+<p><hr>
+
+
</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">
-<p><hr>
+<a name="ntp.conf-Files"></a>
<a name="ntp_002econf-Files"></a>
-<br>
+<p><hr>
+
+
</div>
<h4 class="subsection">ntp.conf Files</h4>
<dl>
-<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
+<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
</dl>
<div class="node">
-<p><hr>
+<a name="ntp.conf-See-Also"></a>
<a name="ntp_002econf-See-Also"></a>
-<br>
+<p><hr>
+
+
</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
-<span class="file">/usr/share/doc/ntp</span>.
+<samp><span class="file">/usr/share/doc/ntp</span></samp>.
<br>
<p><br>
David L. Mills, <em>Network Time Protocol (Version 4)</em>, RFC5905
<div class="node">
-<p><hr>
+<a name="ntp.conf-Bugs"></a>
<a name="ntp_002econf-Bugs"></a>
-<br>
+<p><hr>
+
+
</div>
<h4 class="subsection">ntp.conf Bugs</h4>
detected.
<p>The
-<span class="file">ntpkey_</span><kbd>host</kbd>
+<samp><span class="file">ntpkey_</span></samp><kbd>host</kbd>
files are really digital
certificates.
These should be obtained via secure directory
services when they become universally available.
<div class="node">
-<p><hr>
+<a name="ntp.conf-Notes"></a>
<a name="ntp_002econf-Notes"></a>
-<br>
+<p><hr>
+
+
</div>
<h4 class="subsection">ntp.conf Notes</h4>
<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.7">
+<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family: serif; font-weight: normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<h1 class="settitle">NTP Symmetric Key</h1>
<div class="node">
+<a name="Top"></a>
<p><hr>
-
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntp_002ekeys-Description">ntp.keys Description</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>
</ul>
<div class="node">
+<a name="ntp.keys-Description"></a>
+<a name="ntp_002ekeys-Description"></a>
<p><hr>
-
<a name="ntp_002ekeys-Description"></a>Previous: <a rel="previous" accesskey="p" href="#Top">Top</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">
-<p><hr>
+<a name="ntp.keys-Notes"></a>
<a name="ntp_002ekeys-Notes"></a>
-<br>
+<p><hr>
+
+
</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>
-
<a name="ntp_002ekeys-Files"></a>Next: <a rel="next" accesskey="n" href="#ntp_002ekeys-See-Also">ntp.keys See Also</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><span class="file">/etc/ntp.keys</span><dd>the default name of the configuration file
+<dt><samp><span class="file">/etc/ntp.keys</span></samp><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>
-
<a name="ntp_002ekeys-See-Also"></a>Next: <a rel="next" accesskey="n" href="#ntp_002ekeys-Notes">ntp.keys Notes</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>
-
<a name="ntp_002ekeys-Notes"></a>Previous: <a rel="previous" accesskey="p" href="#ntp_002ekeys-See-Also">ntp.keys See Also</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>
<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.7">
+<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family: serif; font-weight: normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<h1 class="settitle">ntpd: Network Time Protocol (NTP) Daemon User's Manual</h1>
<div class="node">
+<a name="Top"></a>
<p><hr>
-
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntpd-Description">ntpd Description</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>
</ul>
<div class="node">
-<p><hr>
<a name="ntpd-Description"></a>
-<br>
+<p><hr>
+
+
</div>
<!-- node-name, next, previous, up -->
the daemon times out and exits without setting the clock.
<div class="node">
-<p><hr>
<a name="ntpd-Invocation"></a>
-<br>
+<p><hr>
+
+
</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 (<span class="option">--help</span>)
+<li><a accesskey="1" href="#ntpd-usage">ntpd usage</a>: ntpd help/usage (<samp><span class="option">--help</span></samp>)
<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>
-
<a name="ntpd-usage"></a>Next: <a rel="next" accesskey="n" href="#ntpd-ipv4">ntpd ipv4</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 (<span class="option">--help</span>)</h4>
+<h4 class="subsection">ntpd help/usage (<samp><span class="option">--help</span></samp>)</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
-(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
+(<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
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 <span class="file">more</span>. Both will exit
+used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
with a status code of 0.
-<pre class="example">ntpd - NTP daemon program - Ver. 4.2.8p10
+<pre class="example">ntpd - NTP daemon program - Ver. 4.2.8p11
Usage: ntpd [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \
[ <server1> ... <serverN> ]
Flg Arg Option-Name Description
Please send bug reports to: <http://bugs.ntp.org, bugs@ntp.org>
</pre>
<div class="node">
+<a name="ntpd-ipv4"></a>
<p><hr>
-
<a name="ntpd-ipv4"></a>Next: <a rel="next" accesskey="n" href="#ntpd-ipv6">ntpd ipv6</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>
-
<a name="ntpd-ipv6"></a>Next: <a rel="next" accesskey="n" href="#ntpd-authreq">ntpd authreq</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>
-
<a name="ntpd-authreq"></a>Next: <a rel="next" accesskey="n" href="#ntpd-authnoreq">ntpd authnoreq</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>
-
<a name="ntpd-authnoreq"></a>Next: <a rel="next" accesskey="n" href="#ntpd-configfile">ntpd configfile</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>
-
<a name="ntpd-configfile"></a>Next: <a rel="next" accesskey="n" href="#ntpd-driftfile">ntpd driftfile</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,
-<span class="file">/etc/ntp.conf</span>
+<samp><span class="file">/etc/ntp.conf</span></samp>
by default.
<div class="node">
+<a name="ntpd-driftfile"></a>
<p><hr>
-
<a name="ntpd-driftfile"></a>Next: <a rel="next" accesskey="n" href="#ntpd-panicgate">ntpd panicgate</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,
-<span class="file">/etc/ntp.drift</span>
+<samp><span class="file">/etc/ntp.drift</span></samp>
by default.
This is the same operation as the
<code>driftfile</code> <kbd>driftfile</kbd>
configuration specification in the
-<span class="file">/etc/ntp.conf</span>
+<samp><span class="file">/etc/ntp.conf</span></samp>
file.
<div class="node">
+<a name="ntpd-panicgate"></a>
<p><hr>
-
<a name="ntpd-panicgate"></a>Next: <a rel="next" accesskey="n" href="#ntpd-force_002dstep_002donce">ntpd force-step-once</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>
-
<a name="ntpd-force_002dstep_002donce"></a>Next: <a rel="next" accesskey="n" href="#ntpd-jaildir">ntpd jaildir</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>
-
<a name="ntpd-jaildir"></a>Next: <a rel="next" accesskey="n" href="#ntpd-interface">ntpd interface</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>
-
<a name="ntpd-interface"></a>Next: <a rel="next" accesskey="n" href="#ntpd-keyfile">ntpd keyfile</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 <span class="file">iface</span>.
+This option takes a string argument <samp><span class="file">iface</span></samp>.
<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>
-
<a name="ntpd-keyfile"></a>Next: <a rel="next" accesskey="n" href="#ntpd-logfile">ntpd logfile</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.
-<span class="file">/etc/ntp.keys</span>
+<samp><span class="file">/etc/ntp.keys</span></samp>
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>
-
<a name="ntpd-logfile"></a>Next: <a rel="next" accesskey="n" href="#ntpd-novirtualips">ntpd novirtualips</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>
-
<a name="ntpd-novirtualips"></a>Next: <a rel="next" accesskey="n" href="#ntpd-modifymmtimer">ntpd modifymmtimer</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>
-
<a name="ntpd-modifymmtimer"></a>Next: <a rel="next" accesskey="n" href="#ntpd-nice">ntpd nice</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>
-
<a name="ntpd-nice"></a>Next: <a rel="next" accesskey="n" href="#ntpd-pidfile">ntpd pidfile</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>
-
<a name="ntpd-pidfile"></a>Next: <a rel="next" accesskey="n" href="#ntpd-priority">ntpd priority</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>
-
<a name="ntpd-priority"></a>Next: <a rel="next" accesskey="n" href="#ntpd-quit">ntpd quit</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>
-
<a name="ntpd-quit"></a>Next: <a rel="next" accesskey="n" href="#ntpd-propagationdelay">ntpd propagationdelay</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>
-
<a name="ntpd-propagationdelay"></a>Next: <a rel="next" accesskey="n" href="#ntpd-saveconfigquit">ntpd saveconfigquit</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>
-
<a name="ntpd-saveconfigquit"></a>Next: <a rel="next" accesskey="n" href="#ntpd-statsdir">ntpd statsdir</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>
-
<a name="ntpd-statsdir"></a>Next: <a rel="next" accesskey="n" href="#ntpd-trustedkey">ntpd trustedkey</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>
-
<a name="ntpd-trustedkey"></a>Next: <a rel="next" accesskey="n" href="#ntpd-user">ntpd user</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 <span class="file">tkey</span>.
+This option takes a string argument <samp><span class="file">tkey</span></samp>.
<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>
-
<a name="ntpd-user"></a>Next: <a rel="next" accesskey="n" href="#ntpd-updateinterval">ntpd updateinterval</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>
-
<a name="ntpd-updateinterval"></a>Next: <a rel="next" accesskey="n" href="#ntpd-wait_002dsync">ntpd wait-sync</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>
-
<a name="ntpd-wait_002dsync"></a>Next: <a rel="next" accesskey="n" href="#ntpd-slew">ntpd slew</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>
-
<a name="ntpd-slew"></a>Next: <a rel="next" accesskey="n" href="#ntpd-usepcc">ntpd usepcc</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>
-
<a name="ntpd-usepcc"></a>Next: <a rel="next" accesskey="n" href="#ntpd-pccfreq">ntpd pccfreq</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>
-
<a name="ntpd-pccfreq"></a>Next: <a rel="next" accesskey="n" href="#ntpd-mdns">ntpd mdns</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>
-
<a name="ntpd-mdns"></a>Next: <a rel="next" accesskey="n" href="#ntpd-config">ntpd config</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>
-
<a name="ntpd-config"></a>Next: <a rel="next" accesskey="n" href="#ntpd-exit-status">ntpd exit status</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><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.
+<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.
</dl>
<div class="node">
+<a name="ntpd-exit-status"></a>
<p><hr>
-
<a name="ntpd-exit-status"></a>Next: <a rel="next" accesskey="n" href="#ntpd-Usage">ntpd Usage</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><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.
+<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.
</dl>
<div class="node">
+<a name="ntpd-Usage"></a>
<p><hr>
-
<a name="ntpd-Usage"></a>Next: <a rel="next" accesskey="n" href="#ntpd-Files">ntpd Files</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>
-
<a name="ntpd-Files"></a>Next: <a rel="next" accesskey="n" href="#ntpd-See-Also">ntpd See Also</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>
-
<a name="ntpd-See-Also"></a>Next: <a rel="next" accesskey="n" href="#ntpd-Bugs">ntpd Bugs</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>
-
<a name="ntpd-Bugs"></a>Next: <a rel="next" accesskey="n" href="#ntpd-Notes">ntpd Notes</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>
-
<a name="ntpd-Notes"></a>Previous: <a rel="previous" accesskey="p" href="#ntpd-Bugs">ntpd Bugs</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">
-<p><hr>
<a name="Usage"></a>
-<br>
+<p><hr>
+
+
</div>
<!-- node-name, next, previous, up -->
<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.7">
+<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family: serif; font-weight: normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<h1 class="settitle">ntpdc: NTPD Control User's Manual</h1>
<div class="node">
+<a name="Top"></a>
<p><hr>
-
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-Description">ntpdc Description</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>
</ul>
<div class="node">
-<p><hr>
<a name="ntpdc-Description"></a>
-<br>
+<p><hr>
+
+
</div>
<!-- node-name, next, previous, up -->
error bound of the system clock relative to the server clock.
<div class="node">
-<p><hr>
<a name="ntpdc-Invocation"></a>
-<br>
+<p><hr>
+
+
</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 (<span class="option">--help</span>)
+<li><a accesskey="1" href="#ntpdc-usage">ntpdc usage</a>: ntpdc help/usage (<samp><span class="option">--help</span></samp>)
<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>
-
<a name="ntpdc-usage"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-ipv4">ntpdc ipv4</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 (<span class="option">--help</span>)</h4>
+<h4 class="subsection">ntpdc help/usage (<samp><span class="option">--help</span></samp>)</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
-(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
+(<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
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 <span class="file">more</span>. Both will exit
+used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
with a status code of 0.
<pre class="example">ntpdc - vendor-specific NTPD control program - Ver. 4.2.8p11
Please send bug reports to: <http://bugs.ntp.org, bugs@ntp.org>
</pre>
<div class="node">
+<a name="ntpdc-ipv4"></a>
<p><hr>
-
<a name="ntpdc-ipv4"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-ipv6">ntpdc ipv6</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>
-
<a name="ntpdc-ipv6"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-command">ntpdc command</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>
-
<a name="ntpdc-command"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-interactive">ntpdc interactive</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 <span class="file">cmd</span>.
+This option takes a string argument <samp><span class="file">cmd</span></samp>.
<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>
-
<a name="ntpdc-interactive"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-listpeers">ntpdc listpeers</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>
-
<a name="ntpdc-listpeers"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-numeric">ntpdc numeric</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>
-
<a name="ntpdc-numeric"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-peers">ntpdc peers</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>
-
<a name="ntpdc-peers"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-showpeers">ntpdc showpeers</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>
-
<a name="ntpdc-showpeers"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-config">ntpdc config</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>
-
<a name="ntpdc-config"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-exit-status">ntpdc exit status</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 <span class="file">ntpdc</span> runs.
+are expanded and replaced when <samp><span class="file">ntpdc</span></samp> runs.
For any of these that are plain files, they are simply processed.
-For any that are directories, then a file named <span class="file">.ntprc</span> is searched for
+For any that are directories, then a file named <samp><span class="file">.ntprc</span></samp> 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><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.
+<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.
</dl>
<div class="node">
+<a name="ntpdc-exit-status"></a>
<p><hr>
-
<a name="ntpdc-exit-status"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-Usage">ntpdc Usage</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><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
+<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
it to autogen-users@lists.sourceforge.net. Thank you.
</dl>
<div class="node">
+<a name="ntpdc-Usage"></a>
<p><hr>
-
<a name="ntpdc-Usage"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-See-Also">ntpdc See Also</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>
-
<a name="ntpdc-See-Also"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-Authors">ntpdc Authors</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>
-
<a name="ntpdc-Authors"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-Bugs">ntpdc Bugs</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>
-
<a name="ntpdc-Bugs"></a>Previous: <a rel="previous" accesskey="p" href="#ntpdc-Authors">ntpdc Authors</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">
-<p><hr>
<a name="Usage"></a>
-<br>
+<p><hr>
+
+
</div>
<!-- node-name, next, previous, up -->
<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.7">
+<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family: serif; font-weight: normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
+<a name="Top"></a>
<p><hr>
-
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntpsnmpd-Description">ntpsnmpd Description</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>
</ul>
<div class="node">
+<a name="ntpsnmpd-Description"></a>
<p><hr>
-
<a name="ntpsnmpd-Description"></a>Next: <a rel="next" accesskey="n" href="#Usage">Usage</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>
-
<a name="Usage"></a>Previous: <a rel="previous" accesskey="p" href="#ntpsnmpd-Description">ntpsnmpd Description</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 -->
<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.7">
+<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family: serif; font-weight: normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<h1 class="settitle">Ntp-wait User's Manual</h1>
<div class="node">
+<a name="Top"></a>
<p><hr>
-
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-Description">ntp-wait Description</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.
</ul>
<div class="node">
-<p><hr>
+<a name="ntp-wait-Invocation"></a>
<a name="ntp_002dwait-Invocation"></a>
-<br>
+<p><hr>
+
+
</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 (<span class="option">--help</span>)
+<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="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>
-
<a name="ntp_002dwait-usage"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-tries">ntp-wait tries</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 (<span class="option">--help</span>)</h4>
+<h4 class="subsection">0.1.1 ntp-wait help/usage (<samp><span class="option">--help</span></samp>)</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
-(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
+(<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
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 <span class="file">more</span>. Both will exit
+used to select the program, defaulting to <samp><span class="file">more</span></samp>. 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
hyphen and the flag character.
</pre>
<div class="node">
+<a name="ntp-wait-tries"></a>
+<a name="ntp_002dwait-tries"></a>
<p><hr>
-
<a name="ntp_002dwait-tries"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-sleep">ntp-wait sleep</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>
-
<a name="ntp_002dwait-sleep"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-verbose">ntp-wait verbose</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 <span class="file">secs-between-tries</span>.
- We will sleep for <span class="file">secs-between-tries</span> after each query
+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
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>
-
<a name="ntp_002dwait-verbose"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-exit-status">ntp-wait exit status</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>
-
<a name="ntp_002dwait-exit-status"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-Authors">ntp-wait Authors</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><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.
+<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.
</dl>
<div class="node">
+<a name="ntp-wait-Authors"></a>
+<a name="ntp_002dwait-Authors"></a>
<p><hr>
-
<a name="ntp_002dwait-Authors"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-Notes">ntp-wait Notes</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>
-
<a name="ntp_002dwait-Notes"></a>Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait-Authors">ntp-wait Authors</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>
<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.7">
+<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family: serif; font-weight: normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<h1 class="settitle">ntpsweep User's Manual</h1>
<div class="node">
+<a name="Top"></a>
<p><hr>
-
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntpsweep-Description">ntpsweep Description</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.
</ul>
<div class="node">
-<p><hr>
<a name="ntpsweep-Invocation"></a>
-<br>
+<p><hr>
+
+
</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 (<span class="option">--help</span>)
+<li><a accesskey="1" href="#ntpsweep-usage">ntpsweep usage</a>: ntpsweep help/usage (<samp><span class="option">--help</span></samp>)
<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>
-
<a name="ntpsweep-usage"></a>Next: <a rel="next" accesskey="n" href="#ntpsweep-host_002dlist">ntpsweep host-list</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 (<span class="option">--help</span>)</h4>
+<h4 class="subsection">0.1.1 ntpsweep help/usage (<samp><span class="option">--help</span></samp>)</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
-(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
+(<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
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 <span class="file">more</span>. Both will exit
+used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
with a status code of 0.
<pre class="example">ntpsweep - Print various informations about given ntp servers - Ver. 4.2.8p11
hyphen and the flag character.
</pre>
<div class="node">
+<a name="ntpsweep-host-list"></a>
+<a name="ntpsweep-host_002dlist"></a>
<p><hr>
-
<a name="ntpsweep-host_002dlist"></a>Next: <a rel="next" accesskey="n" href="#ntpsweep-peers">ntpsweep peers</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>
-
<a name="ntpsweep-peers"></a>Next: <a rel="next" accesskey="n" href="#ntpsweep-maxlevel">ntpsweep maxlevel</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 <span class="samp">doc</span> documentation.
+This option has no ‘<samp><span class="samp">doc</span></samp>’ documentation.
<div class="node">
+<a name="ntpsweep-maxlevel"></a>
<p><hr>
-
<a name="ntpsweep-maxlevel"></a>Next: <a rel="next" accesskey="n" href="#ntpsweep-strip">ntpsweep strip</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 <span class="samp">doc</span> documentation.
+This option has no ‘<samp><span class="samp">doc</span></samp>’ documentation.
<div class="node">
+<a name="ntpsweep-strip"></a>
<p><hr>
-
<a name="ntpsweep-strip"></a>Next: <a rel="next" accesskey="n" href="#ntpsweep-host">ntpsweep host</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 <span class="samp">doc</span> documentation.
+This option has no ‘<samp><span class="samp">doc</span></samp>’ documentation.
<div class="node">
+<a name="ntpsweep-host"></a>
<p><hr>
-
<a name="ntpsweep-host"></a>Next: <a rel="next" accesskey="n" href="#ntpsweep-exit-status">ntpsweep exit status</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 <span class="samp">doc</span> documentation.
+This option has no ‘<samp><span class="samp">doc</span></samp>’ documentation.
<p><strong>NOTE</strong><strong>: THIS OPTION IS DEPRECATED</strong>
<div class="node">
+<a name="ntpsweep-exit-status"></a>
<p><hr>
-
<a name="ntpsweep-exit-status"></a>Previous: <a rel="previous" accesskey="p" href="#ntpsweep-host">ntpsweep host</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><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.
+<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.
</dl>
</body></html>
<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.7">
+<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family: serif; font-weight: normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<h1 class="settitle">Ntptrace User's Manual</h1>
<div class="node">
+<a name="Top"></a>
<p><hr>
-
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntptrace-Description">ntptrace Description</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>
</ul>
<div class="node">
+<a name="ntptrace-Invocation"></a>
<p><hr>
-
<a name="ntptrace-Invocation"></a>Previous: <a rel="previous" accesskey="p" href="#ntptrace-Description">ntptrace Description</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 (<span class="option">--help</span>)
+<li><a accesskey="1" href="#ntptrace-usage">ntptrace usage</a>: ntptrace help/usage (<samp><span class="option">--help</span></samp>)
<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>
-
<a name="ntptrace-usage"></a>Next: <a rel="next" accesskey="n" href="#ntptrace-numeric">ntptrace numeric</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 (<span class="option">--help</span>)</h4>
+<h4 class="subsection">ntptrace help/usage (<samp><span class="option">--help</span></samp>)</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
-(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
+(<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
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 <span class="file">more</span>. Both will exit
+used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
with a status code of 0.
<pre class="example">ntptrace - Trace peers of an NTP server - Ver. 4.2.8p11
hyphen and the flag character.
</pre>
<div class="node">
+<a name="ntptrace-numeric"></a>
<p><hr>
-
<a name="ntptrace-numeric"></a>Next: <a rel="next" accesskey="n" href="#ntptrace-max_002dhosts">ntptrace max-hosts</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>
-
<a name="ntptrace-max_002dhosts"></a>Next: <a rel="next" accesskey="n" href="#ntptrace-host">ntptrace host</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 <span class="samp">doc</span> documentation.
+This option has no ‘<samp><span class="samp">doc</span></samp>’ documentation.
<div class="node">
+<a name="ntptrace-host"></a>
<p><hr>
-
<a name="ntptrace-host"></a>Next: <a rel="next" accesskey="n" href="#ntptrace-exit-status">ntptrace exit status</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 <span class="samp">doc</span> documentation.
+This option has no ‘<samp><span class="samp">doc</span></samp>’ documentation.
<div class="node">
+<a name="ntptrace-exit-status"></a>
<p><hr>
-
<a name="ntptrace-exit-status"></a>Previous: <a rel="previous" accesskey="p" href="#ntptrace-host">ntptrace host</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><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.
+<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.
</dl>
</body></html>
<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.7">
+<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family: serif; font-weight: normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<h1 class="settitle">Plot_summary User's Manual</h1>
<div class="node">
+<a name="Top"></a>
<p><hr>
-
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#plot_005fsummary-Description">plot_summary Description</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>
</ul>
<div class="node">
+<a name="plot_summary-Invocation"></a>
+<a name="plot_005fsummary-Invocation"></a>
<p><hr>
-
<a name="plot_005fsummary-Invocation"></a>Previous: <a rel="previous" accesskey="p" href="#plot_005fsummary-Description">plot_summary Description</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 (<span class="option">--help</span>)
+<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="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>
-
<a name="plot_005fsummary-usage"></a>Next: <a rel="next" accesskey="n" href="#plot_005fsummary-directory">plot_summary directory</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 (<span class="option">--help</span>)</h4>
+<h4 class="subsection">plot_summary help/usage (<samp><span class="option">--help</span></samp>)</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
-(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
+(<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
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 <span class="file">more</span>. Both will exit
+used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
with a status code of 0.
<pre class="example">plot_summary - plot statistics generated by summary script - Ver. 4.2.8p11
hyphen and the flag character.
</pre>
<div class="node">
+<a name="plot_summary-directory"></a>
+<a name="plot_005fsummary-directory"></a>
<p><hr>
-
<a name="plot_005fsummary-directory"></a>Next: <a rel="next" accesskey="n" href="#plot_005fsummary-identifier">plot_summary identifier</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>
-
<a name="plot_005fsummary-identifier"></a>Next: <a rel="next" accesskey="n" href="#plot_005fsummary-peer">plot_summary peer</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>
-
<a name="plot_005fsummary-peer"></a>Next: <a rel="next" accesskey="n" href="#plot_005fsummary-plot_002dterm">plot_summary plot-term</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>
-
<a name="plot_005fsummary-plot_002dterm"></a>Next: <a rel="next" accesskey="n" href="#plot_005fsummary-output_002dfile">plot_summary output-file</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>
-
<a name="plot_005fsummary-output_002dfile"></a>Next: <a rel="next" accesskey="n" href="#plot_005fsummary-exit-status">plot_summary exit status</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>
-
<a name="plot_005fsummary-exit-status"></a>Previous: <a rel="previous" accesskey="p" href="#plot_005fsummary-output_002dfile">plot_summary output-file</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><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.
+<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.
</dl>
</body></html>
<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.7">
+<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family: serif; font-weight: normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<h1 class="settitle">Summary User's Manual</h1>
<div class="node">
+<a name="Top"></a>
<p><hr>
-
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#summary-Description">summary Description</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>
</ul>
<div class="node">
+<a name="summary-Invocation"></a>
<p><hr>
-
<a name="summary-Invocation"></a>Previous: <a rel="previous" accesskey="p" href="#summary-Description">summary Description</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 (<span class="option">--help</span>)
+<li><a accesskey="1" href="#summary-usage">summary usage</a>: summary help/usage (<samp><span class="option">--help</span></samp>)
<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>
-
<a name="summary-usage"></a>Next: <a rel="next" accesskey="n" href="#summary-directory">summary directory</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 (<span class="option">--help</span>)</h4>
+<h4 class="subsection">summary help/usage (<samp><span class="option">--help</span></samp>)</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
-(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
+(<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
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 <span class="file">more</span>. Both will exit
+used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
with a status code of 0.
<pre class="example">summary - compute various stastics from NTP stat files - Ver. 4.2.8p11
hyphen and the flag character.
</pre>
<div class="node">
+<a name="summary-directory"></a>
<p><hr>
-
<a name="summary-directory"></a>Next: <a rel="next" accesskey="n" href="#summary-end_002ddate">summary end-date</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>
-
<a name="summary-end_002ddate"></a>Next: <a rel="next" accesskey="n" href="#summary-output_002ddirectory">summary output-directory</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>
-
<a name="summary-output_002ddirectory"></a>Next: <a rel="next" accesskey="n" href="#summary-start_002ddate">summary start-date</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>
-
<a name="summary-start_002ddate"></a>Next: <a rel="next" accesskey="n" href="#summary-exit-status">summary exit status</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>
-
<a name="summary-exit-status"></a>Previous: <a rel="previous" accesskey="p" href="#summary-start_002ddate">summary start-date</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><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.
+<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.
</dl>
</body></html>
<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.7">
+<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family: serif; font-weight: normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<h1 class="settitle">update-leap User's Manual</h1>
<div class="node">
+<a name="Top"></a>
<p><hr>
-
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-Description">update-leap Description</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.
</ul>
<div class="node">
-<p><hr>
+<a name="update-leap-Invocation"></a>
<a name="update_002dleap-Invocation"></a>
-<br>
+<p><hr>
+
+
</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 (<span class="option">--help</span>)
+<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="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>
-
<a name="update_002dleap-usage"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-source_002durl">update-leap source-url</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 (<span class="option">--help</span>)</h4>
+<h4 class="subsection">0.1.1 update-leap help/usage (<samp><span class="option">--help</span></samp>)</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
-(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
+(<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
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 <span class="file">more</span>. Both will exit
+used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
with a status code of 0.
<pre class="example">
+Usage: update-leap [options]
+
+Verifies and if necessary, updates leap-second definition file
+
+All arguments are optional: Default (or current value) shown:
+ -C Absolute path to CA Cert (see SSL/TLS Considerations)
+ -D Path to a CAdir (see SSL/TLS Considerations)
+ -e Specify how long (in days) before expiration the file is to be
+ refreshed. Note that larger values imply more frequent refreshes.
+ 60
+ -F Force update even if current file is OK and not close to expiring.
+ -f Absolute path ntp.conf file (default /etc/ntp.conf)
+ /etc/ntp.conf
+ -h show help
+ -i Specify number of minutes between retries
+ 10
+ -L Absolute path to leapfile on the local system
+ (overrides value in ntp.conf)
+ -l Specify the syslog(3) facility for logging
+ LOG_USER
+ -q Only report errors (cannot be used with -v)
+ -r Specify number of attempts to retrieve file
+ 6
+ -s Send output to syslog(3) - implied if STDOUT has no tty or redirected
+ -t Send output to terminal - implied if STDOUT attached to terminal
+ -u Specify the URL of the master copy to download
+ https://www.ietf.org/timezones/data/leap-seconds.list
+ -v Verbose - show debug messages (cannot be used with -q)
+
+The following options are not (yet) implemented in the perl version:
+ -4 Use only IPv4
+ -6 Use only IPv6
+ -c Command to restart NTP after installing a new file
+ <none> - ntpd checks file daily
+ -p 4|6
+ Prefer IPv4 or IPv6 (as specified) addresses, but use either
+
+update-leap will validate the file currently on the local system.
+
+Ordinarily, the leapfile is found using the 'leapfile' directive in
+/etc/ntp.conf. However, an alternate location can be specified on the
+command line with the -L flag.
+
+If the leapfile does not exist, is not valid, has expired, or is
+expiring soon, a new copy will be downloaded. If the new copy is
+valid, it is installed.
+
+If the current file is acceptable, no download or restart occurs.
+
+This can be run as a cron job. As the file is rarely updated, and
+leap seconds are announced at least one month in advance (usually
+longer), it need not be run more frequently than about once every
+three weeks.
+
+SSL/TLS Considerations
+-----------------------
+The perl modules can usually locate the CA certificate used to verify
+the peer's identity.
+
+On BSDs, the default is typically the file /etc/ssl/certs.pem. On
+Linux, the location is typically a path to a CAdir - a directory of
+symlinks named according to a hash of the certificates' subject names.
+
+The -C or -D options are available to pass in a location if no CA cert
+is found in the default location.
+
+External Dependencies
+---------------------
+The following perl modules are required:
+HTTP::Tiny - version >= 0.056
+IO::Socket::SSL - version >= 1.56
+NET::SSLeay - version >= 1.49
+
+Version: 1.004
</pre>
<div class="node">
+<a name="update-leap-source-url"></a>
+<a name="update_002dleap-source_002durl"></a>
<p><hr>
-
<a name="update_002dleap-source_002durl"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-ipv4">update-leap ipv4</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>
-
<a name="update_002dleap-ipv4"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-destination">update-leap destination</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>
-
<a name="update_002dleap-destination"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-expiration">update-leap expiration</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 <span class="file">float</span>.
+This option takes a string argument <samp><span class="file">float</span></samp>.
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>
-
<a name="update_002dleap-expiration"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-ntp_002dconf_002dfile">update-leap ntp-conf-file</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>
-
<a name="update_002dleap-ntp_002dconf_002dfile"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-force_002dupdate">update-leap force-update</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>
-
<a name="update_002dleap-force_002dupdate"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-exit-status">update-leap exit status</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>
-
<a name="update_002dleap-exit-status"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-Usage">update-leap Usage</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><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.
+<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.
</dl>
<div class="node">
+<a name="update-leap-Usage"></a>
+<a name="update_002dleap-Usage"></a>
<p><hr>
-
<a name="update_002dleap-Usage"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-Authors">update-leap Authors</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>
-
<a name="update_002dleap-Authors"></a>Previous: <a rel="previous" accesskey="p" href="#update_002dleap-Usage">update-leap Usage</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>
<title>Sntp User's Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Sntp User's Manual">
-<meta name="generator" content="makeinfo 4.7">
+<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family: serif; font-weight: normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<h1 class="settitle">Sntp User's Manual</h1>
<div class="node">
+<a name="Top"></a>
<p><hr>
-
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#sntp-Description">sntp Description</a>,
+Next: <a rel="next" accesskey="n" href="#sntp-Description">sntp Description</a>,
Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>,
Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
-<br>
+
</div>
<h2 class="unnumbered">Simple Network Time Protocol User Manual</h2>
</ul>
<div class="node">
-<p><hr>
<a name="sntp-Description"></a>
-<br>
+<p><hr>
+
+
</div>
<!-- node-name, next, previous, up -->
error bound of the system clock relative to the server clock.
<div class="node">
-<p><hr>
<a name="sntp-Invocation"></a>
-<br>
+<p><hr>
+
+
</div>
<h3 class="section">Invoking sntp</h3>
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 (<span class="option">--help</span>)
+<li><a accesskey="1" href="#sntp-usage">sntp usage</a>: sntp help/usage (<samp><span class="option">--help</span></samp>)
<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>
-
<a name="sntp-usage"></a>Next: <a rel="next" accesskey="n" href="#sntp-ipv4">sntp ipv4</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 (<span class="option">--help</span>)</h4>
+<h4 class="subsection">sntp help/usage (<samp><span class="option">--help</span></samp>)</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
-(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
+(<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
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 <span class="file">more</span>. Both will exit
+used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
with a status code of 0.
<pre class="example">sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p245
please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
</pre>
<div class="node">
+<a name="sntp-ipv4"></a>
<p><hr>
-
<a name="sntp-ipv4"></a>Next: <a rel="next" accesskey="n" href="#sntp-ipv6">sntp ipv6</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>
-
<a name="sntp-ipv6"></a>Next: <a rel="next" accesskey="n" href="#sntp-authentication">sntp authentication</a>,
+Next: <a rel="next" accesskey="n" href="#sntp-authentication">sntp authentication</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-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>
-
<a name="sntp-authentication"></a>Next: <a rel="next" accesskey="n" href="#sntp-broadcast">sntp broadcast</a>,
+Next: <a rel="next" accesskey="n" href="#sntp-broadcast">sntp broadcast</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-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 <span class="file">auth-keynumber</span>.
+This option takes a number argument <samp><span class="file">auth-keynumber</span></samp>.
Enable authentication using the key specified in this option's
-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.
+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.
<div class="node">
+<a name="sntp-broadcast"></a>
<p><hr>
-
<a name="sntp-broadcast"></a>Next: <a rel="next" accesskey="n" href="#sntp-concurrent">sntp concurrent</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 <span class="file">broadcast-address</span>.
+This option takes a string argument <samp><span class="file">broadcast-address</span></samp>.
<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 <span class="option">-t</span>.
+can (and probably should) be modified with <samp><span class="option">-t</span></samp>.
<div class="node">
+<a name="sntp-concurrent"></a>
<p><hr>
-
<a name="sntp-concurrent"></a>Next: <a rel="next" accesskey="n" href="#sntp-gap">sntp gap</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 <span class="file">host-name</span>.
+This option takes a string argument <samp><span class="file">host-name</span></samp>.
<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 <span class="option">-c</span> or <span class="option">--concurrent</span> flag says that any IPs
+ <p>The <samp><span class="option">-c</span></samp> or <samp><span class="option">--concurrent</span></samp> 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>
-
<a name="sntp-gap"></a>Next: <a rel="next" accesskey="n" href="#sntp-kod">sntp kod</a>,
+Next: <a rel="next" accesskey="n" href="#sntp-kod">sntp kod</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-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 <span class="file">milliseconds</span>.
+This option takes a number argument <samp><span class="file">milliseconds</span></samp>.
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>
-
<a name="sntp-kod"></a>Next: <a rel="next" accesskey="n" href="#sntp-keyfile">sntp keyfile</a>,
+Next: <a rel="next" accesskey="n" href="#sntp-keyfile">sntp keyfile</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-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 <span class="file">file-name</span>.
+This option takes a file argument <samp><span class="file">file-name</span></samp>.
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>
-
<a name="sntp-keyfile"></a>Next: <a rel="next" accesskey="n" href="#sntp-logfile">sntp logfile</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 <span class="option">-a</span>” option.
-This option takes a file argument <span class="file">file-name</span>.
+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 option specifies the keyfile.
-<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
+<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
information.
<div class="node">
+<a name="sntp-logfile"></a>
<p><hr>
-
<a name="sntp-logfile"></a>Next: <a rel="next" accesskey="n" href="#sntp-steplimit">sntp steplimit</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 <span class="file">file-name</span>.
+This option takes a file argument <samp><span class="file">file-name</span></samp>.
This option causes the client to write log messages to the specified
-<span class="file">logfile</span>.
+<samp><span class="file">logfile</span></samp>.
<div class="node">
+<a name="sntp-steplimit"></a>
<p><hr>
-
<a name="sntp-steplimit"></a>Next: <a rel="next" accesskey="n" href="#sntp-ntpversion">sntp ntpversion</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 <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,
+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,
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>
-
<a name="sntp-ntpversion"></a>Next: <a rel="next" accesskey="n" href="#sntp-usereservedport">sntp usereservedport</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 <span class="file">ntpversion</span> .
+NTP protocol version <samp><span class="file">ntpversion</span></samp> .
<div class="node">
+<a name="sntp-usereservedport"></a>
<p><hr>
-
<a name="sntp-usereservedport"></a>Next: <a rel="next" accesskey="n" href="#sntp-timeout">sntp timeout</a>,
+Next: <a rel="next" accesskey="n" href="#sntp-timeout">sntp timeout</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-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>
-
<a name="sntp-timeout"></a>Next: <a rel="next" accesskey="n" href="#sntp-wait">sntp wait</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 <span class="file">seconds</span>.
+This option takes a number argument <samp><span class="file">seconds</span></samp>.
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>
-
<a name="sntp-wait"></a>Next: <a rel="next" accesskey="n" href="#sntp-config">sntp config</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>
-
<a name="sntp-config"></a>Next: <a rel="next" accesskey="n" href="#sntp-exit-status">sntp exit status</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 <span class="file">sntp</span> runs.
+are expanded and replaced when <samp><span class="file">sntp</span></samp> runs.
For any of these that are plain files, they are simply processed.
-For any that are directories, then a file named <span class="file">.ntprc</span> is searched for
+For any that are directories, then a file named <samp><span class="file">.ntprc</span></samp> 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><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.
+<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.
</dl>
<div class="node">
+<a name="sntp-exit-status"></a>
<p><hr>
-
<a name="sntp-exit-status"></a>Next: <a rel="next" accesskey="n" href="#sntp-Usage">sntp Usage</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><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
+<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
it to autogen-users@lists.sourceforge.net. Thank you.
</dl>
<div class="node">
+<a name="sntp-Usage"></a>
<p><hr>
-
<a name="sntp-Usage"></a>Next: <a rel="next" accesskey="n" href="#sntp-Authors">sntp Authors</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>
-
<a name="sntp-Authors"></a>Previous: <a rel="previous" accesskey="p" href="#sntp-Usage">sntp Usage</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">
-<p><hr>
<a name="Usage"></a>
-<br>
+<p><hr>
+
+
</div>
<!-- node-name, next, previous, up -->
projects / thirdparty / ntp.git / commitdiff
