---
+(4.2.8p13) 2020/03/03 Released by Harlan Stenn <stenn@ntp.org>
* [Sec 3610] process_control() should bail earlier on short packets. stenn@
- Reported by Philippe Antoine
#
# EDIT THIS FILE WITH CAUTION (invoke-ntp.conf.texi)
#
-# It has been AutoGen-ed February 4, 2020 at 11:52:59 PM by AutoGen 5.18.5
+# It has been AutoGen-ed March 3, 2020 at 04:35:45 PM by AutoGen 5.18.5
# From the definitions ntp.conf.def
# and the template file agtexi-file.tpl
@end ignore
See IPv6 references for the
equivalent classes for that address family.
@table @asis
-@item @code{pool} @kbd{address} @code{[@code{burst}]} @code{[@code{iburst}]} @code{[@code{version} @kbd{version}]} @code{[@code{prefer}]} @code{[@code{minpoll} @kbd{minpoll}]} @code{[@code{maxpoll} @kbd{maxpoll}]}
-@item @code{server} @kbd{address} @code{[@code{key} @kbd{key} @kbd{|} @code{autokey}]} @code{[@code{burst}]} @code{[@code{iburst}]} @code{[@code{version} @kbd{version}]} @code{[@code{prefer}]} @code{[@code{minpoll} @kbd{minpoll}]} @code{[@code{maxpoll} @kbd{maxpoll}]} @code{[@code{true}]}
+@item @code{pool} @kbd{address} @code{[@code{burst}]} @code{[@code{iburst}]} @code{[@code{version} @kbd{version}]} @code{[@code{prefer}]} @code{[@code{minpoll} @kbd{minpoll}]} @code{[@code{maxpoll} @kbd{maxpoll}]} @code{[@code{xmtnonce}]}
+@item @code{server} @kbd{address} @code{[@code{key} @kbd{key} @kbd{|} @code{autokey}]} @code{[@code{burst}]} @code{[@code{iburst}]} @code{[@code{version} @kbd{version}]} @code{[@code{prefer}]} @code{[@code{minpoll} @kbd{minpoll}]} @code{[@code{maxpoll} @kbd{maxpoll}]} @code{[@code{true}]} @code{[@code{xmtnonce}]}
@item @code{peer} @kbd{address} @code{[@code{key} @kbd{key} @kbd{|} @code{autokey}]} @code{[@code{version} @kbd{version}]} @code{[@code{prefer}]} @code{[@code{minpoll} @kbd{minpoll}]} @code{[@code{maxpoll} @kbd{maxpoll}]} @code{[@code{true}]} @code{[@code{xleave}]}
@item @code{broadcast} @kbd{address} @code{[@code{key} @kbd{key} @kbd{|} @code{autokey}]} @code{[@code{version} @kbd{version}]} @code{[@code{prefer}]} @code{[@code{minpoll} @kbd{minpoll}]} @code{[@code{ttl} @kbd{ttl}]} @code{[@code{xleave}]}
@item @code{manycastclient} @kbd{address} @code{[@code{key} @kbd{key} @kbd{|} @code{autokey}]} @code{[@code{version} @kbd{version}]} @code{[@code{prefer}]} @code{[@code{minpoll} @kbd{minpoll}]} @code{[@code{maxpoll} @kbd{maxpoll}]} @code{[@code{ttl} @kbd{ttl}]}
The server is discarded by the selection algroithm.
@item @code{preempt}
Says the association can be preempted.
-@item @code{true}
-Marks the server as a truechimer.
-Use this option only for testing.
@item @code{prefer}
Marks the server as preferred.
All other things being equal,
@file{/usr/share/doc/ntp})
for further information.
@item @code{true}
-Forces the association to always survive the selection and clustering algorithms.
+Marks the server as a truechimer,
+forcing the association to always survive the selection and clustering algorithms.
This option should almost certainly
@emph{only}
be used while testing an association.
and
@code{broadcast}
modes only, this flag enables interleave mode.
+@item @code{xmtnonce}
+Valid only for
+@code{server}
+and
+@code{pool}
+modes, this flag puts a random number in the packet's transmit timestamp.
+
@end table
@subsubsection Auxiliary Commands
@table @asis
@code{ntpport}
is considered more specific and
is sorted later in the list.
+@item @code{serverresponse fuzz}
+When reponding to server requests,
+fuzz the low order bits of the
+@code{reftime}.
@item @code{version}
Deny packets that do not match the current NTP version.
@end table
one telephone number used to dial the telephone JJY service.
The Hayes command ATDT is normally prepended to the number.
The number can contain other modem control codes as well.
+@item @code{pollskewlist} @code{[@kbd{poll} @kbd{value} | @kbd{value}]} @kbd{...} @code{[@code{default} @kbd{value} | @kbd{value}]}
+Enable skewing of our poll requests to our servers.
+@kbd{poll}
+is a number between 3 and 17 inclusive, identifying a specific poll interval.
+A poll interval is 2^n seconds in duration,
+so a poll value of 3 corresponds to 8 seconds
+and
+a poll interval of 17 corresponds to
+131,072 seconds, or about a day and a half.
+The next two numbers must be between 0 and one-half of the poll interval,
+inclusive.
+The first number specifies how early the poll may start,
+while
+the second number specifies how late the poll may be delayed.
+With no arguments, internally specified default values are chosen.
@item @code{reset} @code{[@code{allpeers}]} @code{[@code{auth}]} @code{[@code{ctl}]} @code{[@code{io}]} @code{[@code{mem}]} @code{[@code{sys}]} @code{[@code{timer}]}
Reset one or more groups of counters maintained by
@code{ntpd}
#
# EDIT THIS FILE WITH CAUTION (invoke-ntp.keys.texi)
#
-# It has been AutoGen-ed February 4, 2020 at 11:53:00 PM by AutoGen 5.18.5
+# It has been AutoGen-ed March 3, 2020 at 04:35:48 PM by AutoGen 5.18.5
# From the definitions ntp.keys.def
# and the template file agtexi-file.tpl
@end ignore
#
# EDIT THIS FILE WITH CAUTION (invoke-ntpd.texi)
#
-# It has been AutoGen-ed February 4, 2020 at 11:53:01 PM by AutoGen 5.18.5
+# It has been AutoGen-ed March 3, 2020 at 04:35:49 PM by AutoGen 5.18.5
# From the definitions ntpd-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
-g no panicgate Allow the first adjustment to be Big
- may appear multiple times
-G no force-step-once Step any initial offset correction.
- -i Str jaildir Jail directory
+ -i --- jaildir built without --enable-clockctl or --enable-linuxcaps or --enable-solarisprivs
-I Str interface Listen on an interface name or address
- may appear multiple times
-k Str keyfile path to symmetric keys
-s Str statsdir Statistics file location
-t Str trustedkey Trusted key number
- may appear multiple times
- -u Str user Run as userid (or userid:groupid)
+ -u --- user built without --enable-clockctl or --enable-linuxcaps or --enable-solarisprivs
-U Num updateinterval interval in seconds between scans for new or dropped interfaces
Str var make ARG an ntp variable (RW)
- may appear multiple times
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntp.conf 5man "04 Feb 2020" "4.2.8p13" "File Formats"
+.TH ntp.conf 5man "03 Mar 2020" "4.2.8p13" "File Formats"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:03 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:35:51 PM by AutoGen 5.18.5
.\" From the definitions ntp.conf.def
.\" and the template file agman-cmd.tpl
.SH NAME
See IPv6 references for the
equivalent classes for that address family.
.TP 7
-.NOP \f\*[B-Font]pool\f[] \f\*[I-Font]address\f[] [\f\*[B-Font]burst\f[]] [\f\*[B-Font]iburst\f[]] [\f\*[B-Font]version\f[] \f\*[I-Font]version\f[]] [\f\*[B-Font]prefer\f[]] [\f\*[B-Font]minpoll\f[] \f\*[I-Font]minpoll\f[]] [\f\*[B-Font]maxpoll\f[] \f\*[I-Font]maxpoll\f[]]
+.NOP \f\*[B-Font]pool\f[] \f\*[I-Font]address\f[] [\f\*[B-Font]burst\f[]] [\f\*[B-Font]iburst\f[]] [\f\*[B-Font]version\f[] \f\*[I-Font]version\f[]] [\f\*[B-Font]prefer\f[]] [\f\*[B-Font]minpoll\f[] \f\*[I-Font]minpoll\f[]] [\f\*[B-Font]maxpoll\f[] \f\*[I-Font]maxpoll\f[]] [\f\*[B-Font]xmtnonce\f[]]
.TP 7
-.NOP \f\*[B-Font]server\f[] \f\*[I-Font]address\f[] [\f\*[B-Font]key\f[] \f\*[I-Font]key\f[] \f\*[I-Font]\&|\f[] \f\*[B-Font]autokey\f[]] [\f\*[B-Font]burst\f[]] [\f\*[B-Font]iburst\f[]] [\f\*[B-Font]version\f[] \f\*[I-Font]version\f[]] [\f\*[B-Font]prefer\f[]] [\f\*[B-Font]minpoll\f[] \f\*[I-Font]minpoll\f[]] [\f\*[B-Font]maxpoll\f[] \f\*[I-Font]maxpoll\f[]] [\f\*[B-Font]true\f[]]
+.NOP \f\*[B-Font]server\f[] \f\*[I-Font]address\f[] [\f\*[B-Font]key\f[] \f\*[I-Font]key\f[] \f\*[I-Font]\&|\f[] \f\*[B-Font]autokey\f[]] [\f\*[B-Font]burst\f[]] [\f\*[B-Font]iburst\f[]] [\f\*[B-Font]version\f[] \f\*[I-Font]version\f[]] [\f\*[B-Font]prefer\f[]] [\f\*[B-Font]minpoll\f[] \f\*[I-Font]minpoll\f[]] [\f\*[B-Font]maxpoll\f[] \f\*[I-Font]maxpoll\f[]] [\f\*[B-Font]true\f[]] [\f\*[B-Font]xmtnonce\f[]]
.TP 7
.NOP \f\*[B-Font]peer\f[] \f\*[I-Font]address\f[] [\f\*[B-Font]key\f[] \f\*[I-Font]key\f[] \f\*[I-Font]\&|\f[] \f\*[B-Font]autokey\f[]] [\f\*[B-Font]version\f[] \f\*[I-Font]version\f[]] [\f\*[B-Font]prefer\f[]] [\f\*[B-Font]minpoll\f[] \f\*[I-Font]minpoll\f[]] [\f\*[B-Font]maxpoll\f[] \f\*[I-Font]maxpoll\f[]] [\f\*[B-Font]true\f[]] [\f\*[B-Font]xleave\f[]]
.TP 7
.NOP \f\*[B-Font]preempt\f[]
Says the association can be preempted.
.TP 7
-.NOP \f\*[B-Font]true\f[]
-Marks the server as a truechimer.
-Use this option only for testing.
-.TP 7
.NOP \f\*[B-Font]prefer\f[]
Marks the server as preferred.
All other things being equal,
for further information.
.TP 7
.NOP \f\*[B-Font]true\f[]
-Forces the association to always survive the selection and clustering algorithms.
+Marks the server as a truechimer,
+forcing the association to always survive the selection and clustering algorithms.
This option should almost certainly
\fIonly\f[]
be used while testing an association.
and
\f\*[B-Font]broadcast\f[]
modes only, this flag enables interleave mode.
+.TP 7
+.NOP \f\*[B-Font]xmtnonce\f[]
+Valid only for
+\f\*[B-Font]server\f[]
+and
+\f\*[B-Font]pool\f[]
+modes, this flag puts a random number in the packet's transmit timestamp.
.PP
.SS Auxiliary Commands
.TP 7
is considered more specific and
is sorted later in the list.
.TP 7
+.NOP \f\*[B-Font]serverresponse fuzz\f[]
+When reponding to server requests,
+fuzz the low order bits of the
+\f\*[B-Font]reftime\f[].
+.TP 7
.NOP \f\*[B-Font]version\f[]
Deny packets that do not match the current NTP version.
.RE
The Hayes command ATDT is normally prepended to the number.
The number can contain other modem control codes as well.
.TP 7
+.NOP \f\*[B-Font]pollskewlist\f[] [\f\*[I-Font]poll\f[] \f\*[I-Font]value\f[] | \f\*[I-Font]value\f[]] \f\*[I-Font]...\f[] [\f\*[B-Font]default\f[] \f\*[I-Font]value\f[] | \f\*[I-Font]value\f[]]
+Enable skewing of our poll requests to our servers.
+\f\*[I-Font]poll\f[]
+is a number between 3 and 17 inclusive, identifying a specific poll interval.
+A poll interval is 2^n seconds in duration,
+so a poll value of 3 corresponds to 8 seconds
+and
+a poll interval of 17 corresponds to
+131,072 seconds, or about a day and a half.
+The next two numbers must be between 0 and one-half of the poll interval,
+inclusive.
+The first number specifies how early the poll may start,
+while
+the second number specifies how late the poll may be delayed.
+With no arguments, internally specified default values are chosen.
+.TP 7
.NOP \f\*[B-Font]reset\f[] [\f\*[B-Font]allpeers\f[]] [\f\*[B-Font]auth\f[]] [\f\*[B-Font]ctl\f[]] [\f\*[B-Font]io\f[]] [\f\*[B-Font]mem\f[]] [\f\*[B-Font]sys\f[]] [\f\*[B-Font]timer\f[]]
Reset one or more groups of counters maintained by
\f\*[B-Font]ntpd\f[]
-.Dd February 4 2020
+.Dd March 3 2020
.Dt NTP_CONF 5mdoc File Formats
.Os
.\" EDIT THIS FILE WITH CAUTION (ntp.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:53 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:35:41 PM by AutoGen 5.18.5
.\" From the definitions ntp.conf.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
.Op Cm prefer
.Op Cm minpoll Ar minpoll
.Op Cm maxpoll Ar maxpoll
+.Op Cm xmtnonce
.Xc
.It Xo Ic server Ar address
.Op Cm key Ar key \&| Cm autokey
.Op Cm minpoll Ar minpoll
.Op Cm maxpoll Ar maxpoll
.Op Cm true
+.Op Cm xmtnonce
.Xc
.It Xo Ic peer Ar address
.Op Cm key Ar key \&| Cm autokey
The server is discarded by the selection algroithm.
.It Cm preempt
Says the association can be preempted.
-.It Cm true
-Marks the server as a truechimer.
-Use this option only for testing.
.It Cm prefer
Marks the server as preferred.
All other things being equal,
.Pa /usr/share/doc/ntp )
for further information.
.It Cm true
-Forces the association to always survive the selection and clustering algorithms.
+Marks the server as a truechimer,
+forcing the association to always survive the selection and clustering algorithms.
This option should almost certainly
.Em only
be used while testing an association.
and
.Cm broadcast
modes only, this flag enables interleave mode.
+.It Cm xmtnonce
+Valid only for
+.Cm server
+and
+.Cm pool
+modes, this flag puts a random number in the packet's transmit timestamp.
.El
.Ss Auxiliary Commands
.Bl -tag -width indent
.Cm ntpport
is considered more specific and
is sorted later in the list.
+.It Ic "serverresponse fuzz"
+When reponding to server requests,
+fuzz the low order bits of the
+.Cm reftime .
.It Cm version
Deny packets that do not match the current NTP version.
.El
one telephone number used to dial the telephone JJY service.
The Hayes command ATDT is normally prepended to the number.
The number can contain other modem control codes as well.
+.It Xo Cm pollskewlist
+.Oo
+.Ar poll
+.Ar value | value
+.Oc
+.Ar ...
+.Oo
+.Cm default
+.Ar value | value
+.Oc
+.Xc
+Enable skewing of our poll requests to our servers.
+.Ar poll
+is a number between 3 and 17 inclusive, identifying a specific poll interval.
+A poll interval is 2^n seconds in duration,
+so a poll value of 3 corresponds to 8 seconds
+and
+a poll interval of 17 corresponds to
+131,072 seconds, or about a day and a half.
+The next two numbers must be between 0 and one\-half of the poll interval,
+inclusive.
+The first number specifies how early the poll may start,
+while
+the second number specifies how late the poll may be delayed.
+With no arguments, internally specified default values are chosen.
.It Xo Ic reset
.Oo
.Ic allpeers
See IPv6 references for the
equivalent classes for that address family.
</p><dl compact="compact">
-<dt><code>pool</code> <kbd>address</kbd> <code>[<code>burst</code>]</code> <code>[<code>iburst</code>]</code> <code>[<code>version</code> <kbd>version</kbd>]</code> <code>[<code>prefer</code>]</code> <code>[<code>minpoll</code> <kbd>minpoll</kbd>]</code> <code>[<code>maxpoll</code> <kbd>maxpoll</kbd>]</code></dt>
-<dt><code>server</code> <kbd>address</kbd> <code>[<code>key</code> <kbd>key</kbd> <kbd>|</kbd> <code>autokey</code>]</code> <code>[<code>burst</code>]</code> <code>[<code>iburst</code>]</code> <code>[<code>version</code> <kbd>version</kbd>]</code> <code>[<code>prefer</code>]</code> <code>[<code>minpoll</code> <kbd>minpoll</kbd>]</code> <code>[<code>maxpoll</code> <kbd>maxpoll</kbd>]</code> <code>[<code>true</code>]</code></dt>
+<dt><code>pool</code> <kbd>address</kbd> <code>[<code>burst</code>]</code> <code>[<code>iburst</code>]</code> <code>[<code>version</code> <kbd>version</kbd>]</code> <code>[<code>prefer</code>]</code> <code>[<code>minpoll</code> <kbd>minpoll</kbd>]</code> <code>[<code>maxpoll</code> <kbd>maxpoll</kbd>]</code> <code>[<code>xmtnonce</code>]</code></dt>
+<dt><code>server</code> <kbd>address</kbd> <code>[<code>key</code> <kbd>key</kbd> <kbd>|</kbd> <code>autokey</code>]</code> <code>[<code>burst</code>]</code> <code>[<code>iburst</code>]</code> <code>[<code>version</code> <kbd>version</kbd>]</code> <code>[<code>prefer</code>]</code> <code>[<code>minpoll</code> <kbd>minpoll</kbd>]</code> <code>[<code>maxpoll</code> <kbd>maxpoll</kbd>]</code> <code>[<code>true</code>]</code> <code>[<code>xmtnonce</code>]</code></dt>
<dt><code>peer</code> <kbd>address</kbd> <code>[<code>key</code> <kbd>key</kbd> <kbd>|</kbd> <code>autokey</code>]</code> <code>[<code>version</code> <kbd>version</kbd>]</code> <code>[<code>prefer</code>]</code> <code>[<code>minpoll</code> <kbd>minpoll</kbd>]</code> <code>[<code>maxpoll</code> <kbd>maxpoll</kbd>]</code> <code>[<code>true</code>]</code> <code>[<code>xleave</code>]</code></dt>
<dt><code>broadcast</code> <kbd>address</kbd> <code>[<code>key</code> <kbd>key</kbd> <kbd>|</kbd> <code>autokey</code>]</code> <code>[<code>version</code> <kbd>version</kbd>]</code> <code>[<code>prefer</code>]</code> <code>[<code>minpoll</code> <kbd>minpoll</kbd>]</code> <code>[<code>ttl</code> <kbd>ttl</kbd>]</code> <code>[<code>xleave</code>]</code></dt>
<dt><code>manycastclient</code> <kbd>address</kbd> <code>[<code>key</code> <kbd>key</kbd> <kbd>|</kbd> <code>autokey</code>]</code> <code>[<code>version</code> <kbd>version</kbd>]</code> <code>[<code>prefer</code>]</code> <code>[<code>minpoll</code> <kbd>minpoll</kbd>]</code> <code>[<code>maxpoll</code> <kbd>maxpoll</kbd>]</code> <code>[<code>ttl</code> <kbd>ttl</kbd>]</code></dt>
<dt><code>preempt</code></dt>
<dd><p>Says the association can be preempted.
</p></dd>
-<dt><code>true</code></dt>
-<dd><p>Marks the server as a truechimer.
-Use this option only for testing.
-</p></dd>
<dt><code>prefer</code></dt>
<dd><p>Marks the server as preferred.
All other things being equal,
for further information.
</p></dd>
<dt><code>true</code></dt>
-<dd><p>Forces the association to always survive the selection and clustering algorithms.
+<dd><p>Marks the server as a truechimer,
+forcing the association to always survive the selection and clustering algorithms.
This option should almost certainly
<em>only</em>
be used while testing an association.
<code>broadcast</code>
modes only, this flag enables interleave mode.
</p></dd>
+<dt><code>xmtnonce</code></dt>
+<dd><p>Valid only for
+<code>server</code>
+and
+<code>pool</code>
+modes, this flag puts a random number in the packet’s transmit timestamp.
+</p>
+</dd>
</dl>
<a name="Auxiliary-Commands"></a>
<h4 class="subsubsection">1.1.1.2 Auxiliary Commands</h4>
is considered more specific and
is sorted later in the list.
</p></dd>
+<dt><code>serverresponse fuzz</code></dt>
+<dd><p>When reponding to server requests,
+fuzz the low order bits of the
+<code>reftime</code>.
+</p></dd>
<dt><code>version</code></dt>
<dd><p>Deny packets that do not match the current NTP version.
</p></dd>
The Hayes command ATDT is normally prepended to the number.
The number can contain other modem control codes as well.
</p></dd>
+<dt><code>pollskewlist</code> <code>[<kbd>poll</kbd> <kbd>value</kbd> | <kbd>value</kbd>]</code> <kbd>...</kbd> <code>[<code>default</code> <kbd>value</kbd> | <kbd>value</kbd>]</code></dt>
+<dd><p>Enable skewing of our poll requests to our servers.
+<kbd>poll</kbd>
+is a number between 3 and 17 inclusive, identifying a specific poll interval.
+A poll interval is 2^n seconds in duration,
+so a poll value of 3 corresponds to 8 seconds
+and
+a poll interval of 17 corresponds to
+131,072 seconds, or about a day and a half.
+The next two numbers must be between 0 and one-half of the poll interval,
+inclusive.
+The first number specifies how early the poll may start,
+while
+the second number specifies how late the poll may be delayed.
+With no arguments, internally specified default values are chosen.
+</p></dd>
<dt><code>reset</code> <code>[<code>allpeers</code>]</code> <code>[<code>auth</code>]</code> <code>[<code>ctl</code>]</code> <code>[<code>io</code>]</code> <code>[<code>mem</code>]</code> <code>[<code>sys</code>]</code> <code>[<code>timer</code>]</code></dt>
<dd><p>Reset one or more groups of counters maintained by
<code>ntpd</code>
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntp.conf 5 "04 Feb 2020" "4.2.8p13" "File Formats"
+.TH ntp.conf 5 "03 Mar 2020" "4.2.8p13" "File Formats"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:03 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:35:51 PM by AutoGen 5.18.5
.\" From the definitions ntp.conf.def
.\" and the template file agman-cmd.tpl
.SH NAME
See IPv6 references for the
equivalent classes for that address family.
.TP 7
-.NOP \f\*[B-Font]pool\f[] \f\*[I-Font]address\f[] [\f\*[B-Font]burst\f[]] [\f\*[B-Font]iburst\f[]] [\f\*[B-Font]version\f[] \f\*[I-Font]version\f[]] [\f\*[B-Font]prefer\f[]] [\f\*[B-Font]minpoll\f[] \f\*[I-Font]minpoll\f[]] [\f\*[B-Font]maxpoll\f[] \f\*[I-Font]maxpoll\f[]]
+.NOP \f\*[B-Font]pool\f[] \f\*[I-Font]address\f[] [\f\*[B-Font]burst\f[]] [\f\*[B-Font]iburst\f[]] [\f\*[B-Font]version\f[] \f\*[I-Font]version\f[]] [\f\*[B-Font]prefer\f[]] [\f\*[B-Font]minpoll\f[] \f\*[I-Font]minpoll\f[]] [\f\*[B-Font]maxpoll\f[] \f\*[I-Font]maxpoll\f[]] [\f\*[B-Font]xmtnonce\f[]]
.TP 7
-.NOP \f\*[B-Font]server\f[] \f\*[I-Font]address\f[] [\f\*[B-Font]key\f[] \f\*[I-Font]key\f[] \f\*[I-Font]\&|\f[] \f\*[B-Font]autokey\f[]] [\f\*[B-Font]burst\f[]] [\f\*[B-Font]iburst\f[]] [\f\*[B-Font]version\f[] \f\*[I-Font]version\f[]] [\f\*[B-Font]prefer\f[]] [\f\*[B-Font]minpoll\f[] \f\*[I-Font]minpoll\f[]] [\f\*[B-Font]maxpoll\f[] \f\*[I-Font]maxpoll\f[]] [\f\*[B-Font]true\f[]]
+.NOP \f\*[B-Font]server\f[] \f\*[I-Font]address\f[] [\f\*[B-Font]key\f[] \f\*[I-Font]key\f[] \f\*[I-Font]\&|\f[] \f\*[B-Font]autokey\f[]] [\f\*[B-Font]burst\f[]] [\f\*[B-Font]iburst\f[]] [\f\*[B-Font]version\f[] \f\*[I-Font]version\f[]] [\f\*[B-Font]prefer\f[]] [\f\*[B-Font]minpoll\f[] \f\*[I-Font]minpoll\f[]] [\f\*[B-Font]maxpoll\f[] \f\*[I-Font]maxpoll\f[]] [\f\*[B-Font]true\f[]] [\f\*[B-Font]xmtnonce\f[]]
.TP 7
.NOP \f\*[B-Font]peer\f[] \f\*[I-Font]address\f[] [\f\*[B-Font]key\f[] \f\*[I-Font]key\f[] \f\*[I-Font]\&|\f[] \f\*[B-Font]autokey\f[]] [\f\*[B-Font]version\f[] \f\*[I-Font]version\f[]] [\f\*[B-Font]prefer\f[]] [\f\*[B-Font]minpoll\f[] \f\*[I-Font]minpoll\f[]] [\f\*[B-Font]maxpoll\f[] \f\*[I-Font]maxpoll\f[]] [\f\*[B-Font]true\f[]] [\f\*[B-Font]xleave\f[]]
.TP 7
.NOP \f\*[B-Font]preempt\f[]
Says the association can be preempted.
.TP 7
-.NOP \f\*[B-Font]true\f[]
-Marks the server as a truechimer.
-Use this option only for testing.
-.TP 7
.NOP \f\*[B-Font]prefer\f[]
Marks the server as preferred.
All other things being equal,
for further information.
.TP 7
.NOP \f\*[B-Font]true\f[]
-Forces the association to always survive the selection and clustering algorithms.
+Marks the server as a truechimer,
+forcing the association to always survive the selection and clustering algorithms.
This option should almost certainly
\fIonly\f[]
be used while testing an association.
and
\f\*[B-Font]broadcast\f[]
modes only, this flag enables interleave mode.
+.TP 7
+.NOP \f\*[B-Font]xmtnonce\f[]
+Valid only for
+\f\*[B-Font]server\f[]
+and
+\f\*[B-Font]pool\f[]
+modes, this flag puts a random number in the packet's transmit timestamp.
.PP
.SS Auxiliary Commands
.TP 7
is considered more specific and
is sorted later in the list.
.TP 7
+.NOP \f\*[B-Font]serverresponse fuzz\f[]
+When reponding to server requests,
+fuzz the low order bits of the
+\f\*[B-Font]reftime\f[].
+.TP 7
.NOP \f\*[B-Font]version\f[]
Deny packets that do not match the current NTP version.
.RE
The Hayes command ATDT is normally prepended to the number.
The number can contain other modem control codes as well.
.TP 7
+.NOP \f\*[B-Font]pollskewlist\f[] [\f\*[I-Font]poll\f[] \f\*[I-Font]value\f[] | \f\*[I-Font]value\f[]] \f\*[I-Font]...\f[] [\f\*[B-Font]default\f[] \f\*[I-Font]value\f[] | \f\*[I-Font]value\f[]]
+Enable skewing of our poll requests to our servers.
+\f\*[I-Font]poll\f[]
+is a number between 3 and 17 inclusive, identifying a specific poll interval.
+A poll interval is 2^n seconds in duration,
+so a poll value of 3 corresponds to 8 seconds
+and
+a poll interval of 17 corresponds to
+131,072 seconds, or about a day and a half.
+The next two numbers must be between 0 and one-half of the poll interval,
+inclusive.
+The first number specifies how early the poll may start,
+while
+the second number specifies how late the poll may be delayed.
+With no arguments, internally specified default values are chosen.
+.TP 7
.NOP \f\*[B-Font]reset\f[] [\f\*[B-Font]allpeers\f[]] [\f\*[B-Font]auth\f[]] [\f\*[B-Font]ctl\f[]] [\f\*[B-Font]io\f[]] [\f\*[B-Font]mem\f[]] [\f\*[B-Font]sys\f[]] [\f\*[B-Font]timer\f[]]
Reset one or more groups of counters maintained by
\f\*[B-Font]ntpd\f[]
-.Dd February 4 2020
+.Dd March 3 2020
.Dt NTP_CONF 5 File Formats
.Os
.\" EDIT THIS FILE WITH CAUTION (ntp.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:53 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:35:41 PM by AutoGen 5.18.5
.\" From the definitions ntp.conf.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
.Op Cm prefer
.Op Cm minpoll Ar minpoll
.Op Cm maxpoll Ar maxpoll
+.Op Cm xmtnonce
.Xc
.It Xo Ic server Ar address
.Op Cm key Ar key \&| Cm autokey
.Op Cm minpoll Ar minpoll
.Op Cm maxpoll Ar maxpoll
.Op Cm true
+.Op Cm xmtnonce
.Xc
.It Xo Ic peer Ar address
.Op Cm key Ar key \&| Cm autokey
The server is discarded by the selection algroithm.
.It Cm preempt
Says the association can be preempted.
-.It Cm true
-Marks the server as a truechimer.
-Use this option only for testing.
.It Cm prefer
Marks the server as preferred.
All other things being equal,
.Pa /usr/share/doc/ntp )
for further information.
.It Cm true
-Forces the association to always survive the selection and clustering algorithms.
+Marks the server as a truechimer,
+forcing the association to always survive the selection and clustering algorithms.
This option should almost certainly
.Em only
be used while testing an association.
and
.Cm broadcast
modes only, this flag enables interleave mode.
+.It Cm xmtnonce
+Valid only for
+.Cm server
+and
+.Cm pool
+modes, this flag puts a random number in the packet's transmit timestamp.
.El
.Ss Auxiliary Commands
.Bl -tag -width indent
.Cm ntpport
is considered more specific and
is sorted later in the list.
+.It Ic "serverresponse fuzz"
+When reponding to server requests,
+fuzz the low order bits of the
+.Cm reftime .
.It Cm version
Deny packets that do not match the current NTP version.
.El
one telephone number used to dial the telephone JJY service.
The Hayes command ATDT is normally prepended to the number.
The number can contain other modem control codes as well.
+.It Xo Cm pollskewlist
+.Oo
+.Ar poll
+.Ar value | value
+.Oc
+.Ar ...
+.Oo
+.Cm default
+.Ar value | value
+.Oc
+.Xc
+Enable skewing of our poll requests to our servers.
+.Ar poll
+is a number between 3 and 17 inclusive, identifying a specific poll interval.
+A poll interval is 2^n seconds in duration,
+so a poll value of 3 corresponds to 8 seconds
+and
+a poll interval of 17 corresponds to
+131,072 seconds, or about a day and a half.
+The next two numbers must be between 0 and one\-half of the poll interval,
+inclusive.
+The first number specifies how early the poll may start,
+while
+the second number specifies how late the poll may be delayed.
+With no arguments, internally specified default values are chosen.
.It Xo Ic reset
.Oo
.Ic allpeers
-.TH ntp.keys 5man "04 Feb 2020" "4.2.8p13" "File Formats"
+.TH ntp.keys 5man "03 Mar 2020" "4.2.8p13" "File Formats"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntp.man)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:05 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:35:52 PM by AutoGen 5.18.5
.\" From the definitions ntp.keys.def
.\" and the template file agman-file.tpl
.Sh NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt NTP_KEYS 5mdoc File Formats
-.Os Linux 3.2.0-4-686-pae
+.Os FreeBSD 11.2-RELEASE_SI
.\" EDIT THIS FILE WITH CAUTION (ntp.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:55 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:35:43 PM by AutoGen 5.18.5
.\" From the definitions ntp.keys.def
.\" and the template file agmdoc-file.tpl
.Sh NAME
-.TH ntp.keys 5 "04 Feb 2020" "4.2.8p13" "File Formats"
+.TH ntp.keys 5 "03 Mar 2020" "4.2.8p13" "File Formats"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntp.man)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:05 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:35:52 PM by AutoGen 5.18.5
.\" From the definitions ntp.keys.def
.\" and the template file agman-file.tpl
.Sh NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt NTP_KEYS 5 File Formats
-.Os Linux 3.2.0-4-686-pae
+.Os FreeBSD 11.2-RELEASE_SI
.\" EDIT THIS FILE WITH CAUTION (ntp.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:55 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:35:43 PM by AutoGen 5.18.5
.\" From the definitions ntp.keys.def
.\" and the template file agmdoc-file.tpl
.Sh NAME
/*
* EDIT THIS FILE WITH CAUTION (ntpd-opts.c)
*
- * It has been AutoGen-ed February 4, 2020 at 11:52:47 PM by AutoGen 5.18.5
+ * It has been AutoGen-ed March 3, 2020 at 04:35:18 PM by AutoGen 5.18.5
* From the definitions ntpd-opts.def
* and the template file options
*
- * Generated from AutoOpts 41:0:16 templates.
+ * Generated from AutoOpts 41:1:16 templates.
*
* AutoOpts is a copyrighted work. This source file is not encumbered
* by AutoOpts licensing, but is provided under the licensing terms chosen
/*
* EDIT THIS FILE WITH CAUTION (ntpd-opts.h)
*
- * It has been AutoGen-ed February 4, 2020 at 11:52:47 PM by AutoGen 5.18.5
+ * It has been AutoGen-ed March 3, 2020 at 04:35:18 PM by AutoGen 5.18.5
* From the definitions ntpd-opts.def
* and the template file options
*
- * Generated from AutoOpts 41:0:16 templates.
+ * Generated from AutoOpts 41:1:16 templates.
*
* AutoOpts is a copyrighted work. This header file is not encumbered
* by AutoOpts licensing, but is provided under the licensing terms chosen
* tolerable version is at least as old as what was current when the header
* template was released.
*/
-#define AO_TEMPLATE_VERSION 167936
+#define AO_TEMPLATE_VERSION 167937
#if (AO_TEMPLATE_VERSION < OPTIONS_MINIMUM_VERSION) \
|| (AO_TEMPLATE_VERSION > OPTIONS_STRUCT_VERSION)
# error option template version mismatches autoopts/options.h header
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntpd 1ntpdman "04 Feb 2020" "4.2.8p13" "User Commands"
+.TH ntpd 1ntpdman "03 Mar 2020" "4.2.8p13" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:06 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:35:53 PM by AutoGen 5.18.5
.\" From the definitions ntpd-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt NTPD 1ntpdmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntpd-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:57 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:35:44 PM by AutoGen 5.18.5
.\" From the definitions ntpd-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntpd @NTPD_MS@ "04 Feb 2020" "4.2.8p13" "User Commands"
+.TH ntpd @NTPD_MS@ "03 Mar 2020" "4.2.8p13" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:06 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:35:53 PM by AutoGen 5.18.5
.\" From the definitions ntpd-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt NTPD @NTPD_MS@ User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntpd-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:57 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:35:44 PM by AutoGen 5.18.5
.\" From the definitions ntpd-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-ntpdc.texi)
#
-# It has been AutoGen-ed February 4, 2020 at 11:53:13 PM by AutoGen 5.18.5
+# It has been AutoGen-ed March 3, 2020 at 04:35:59 PM by AutoGen 5.18.5
# From the definitions ntpdc-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
/*
* EDIT THIS FILE WITH CAUTION (ntpdc-opts.c)
*
- * It has been AutoGen-ed February 4, 2020 at 11:53:07 PM by AutoGen 5.18.5
+ * It has been AutoGen-ed March 3, 2020 at 04:35:55 PM by AutoGen 5.18.5
* From the definitions ntpdc-opts.def
* and the template file options
*
- * Generated from AutoOpts 41:0:16 templates.
+ * Generated from AutoOpts 41:1:16 templates.
*
* AutoOpts is a copyrighted work. This source file is not encumbered
* by AutoOpts licensing, but is provided under the licensing terms chosen
/*
* EDIT THIS FILE WITH CAUTION (ntpdc-opts.h)
*
- * It has been AutoGen-ed February 4, 2020 at 11:53:07 PM by AutoGen 5.18.5
+ * It has been AutoGen-ed March 3, 2020 at 04:35:55 PM by AutoGen 5.18.5
* From the definitions ntpdc-opts.def
* and the template file options
*
- * Generated from AutoOpts 41:0:16 templates.
+ * Generated from AutoOpts 41:1:16 templates.
*
* AutoOpts is a copyrighted work. This header file is not encumbered
* by AutoOpts licensing, but is provided under the licensing terms chosen
* tolerable version is at least as old as what was current when the header
* template was released.
*/
-#define AO_TEMPLATE_VERSION 167936
+#define AO_TEMPLATE_VERSION 167937
#if (AO_TEMPLATE_VERSION < OPTIONS_MINIMUM_VERSION) \
|| (AO_TEMPLATE_VERSION > OPTIONS_STRUCT_VERSION)
# error option template version mismatches autoopts/options.h header
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntpdc 1ntpdcman "04 Feb 2020" "4.2.8p13" "User Commands"
+.TH ntpdc 1ntpdcman "03 Mar 2020" "4.2.8p13" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:14 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:36:01 PM by AutoGen 5.18.5
.\" From the definitions ntpdc-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt NTPDC 1ntpdcmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntpdc-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:11 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:35:58 PM by AutoGen 5.18.5
.\" From the definitions ntpdc-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
-<html lang="en">
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
-<title>ntpdc: NTPD Control User's Manual</title>
-<meta http-equiv="Content-Type" content="text/html">
-<meta name="description" content="ntpdc: NTPD Control User's Manual">
-<meta name="generator" content="makeinfo 4.13">
-<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">
-<style type="text/css"><!--
- pre.display { font-family:inherit }
- pre.format { font-family:inherit }
- pre.smalldisplay { font-family:inherit; font-size:smaller }
- pre.smallformat { font-family:inherit; font-size:smaller }
- pre.smallexample { font-size:smaller }
- pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family:serif; font-weight:normal; }
- span.sansserif { font-family:sans-serif; font-weight:normal; }
---></style>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<title>ntpdc: NTPD Control User’s Manual</title>
+
+<meta name="description" content="ntpdc: NTPD Control User’s Manual">
+<meta name="keywords" content="ntpdc: NTPD Control User’s Manual">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<link href="#Top" rel="start" title="Top">
+<link href="dir.html#Top" rel="up" title="(dir)">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+blockquote.indentedblock {margin-right: 0em}
+blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
+blockquote.smallquotation {font-size: smaller}
+div.display {margin-left: 3.2em}
+div.example {margin-left: 3.2em}
+div.lisp {margin-left: 3.2em}
+div.smalldisplay {margin-left: 3.2em}
+div.smallexample {margin-left: 3.2em}
+div.smalllisp {margin-left: 3.2em}
+kbd {font-style: oblique}
+pre.display {font-family: inherit}
+pre.format {font-family: inherit}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: inherit; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: inherit; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.nolinebreak {white-space: nowrap}
+span.roman {font-family: initial; font-weight: normal}
+span.sansserif {font-family: sans-serif; font-weight: normal}
+ul.no-bullet {list-style: none}
+-->
+</style>
+
+
</head>
-<body>
-<h1 class="settitle">ntpdc: NTPD Control User's Manual</h1>
-<div class="node">
-<a name="Top"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-Description">ntpdc Description</a>,
-Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>,
-Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
-</div>
+<body lang="en">
+<h1 class="settitle" align="center">ntpdc: NTPD Control User’s Manual</h1>
+
+
+
-<h2 class="unnumbered">ntpdc: NTPD Control User Manual</h2>
-<p>This document describes the use of the NTP Project's <code>ntpdc</code> program,
+<a name="Top"></a>
+<div class="header">
+<p>
+Next: <a href="#ntpdc-Description" accesskey="n" rel="next">ntpdc Description</a>, Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> </p>
+</div>
+<a name="ntpdc_003a-NTPD-Control-User-Manual"></a>
+<h1 class="top">ntpdc: NTPD Control User Manual</h1>
+
+<p>This document describes the use of the NTP Project’s <code>ntpdc</code> program,
that can be used to query a Network Time Protocol (NTP) server and
display the time offset of the system clock relative to the server
clock. Run as root, it can correct the system clock to this offset as
well. It can be run as an interactive command or from a cron job.
-
-
<p>This document applies to version 4.2.8p13 of <code>ntpdc</code>.
-
-
<p>The program implements the SNTP protocol as defined by RFC 5905, the NTPv4
+</p>
+<p>This document applies to version 4.2.8p13 of <code>ntpdc</code>.
+</p>
+<p>The program implements the SNTP protocol as defined by RFC 5905, the NTPv4
IETF specification.
+</p>
+<a name="SEC_Overview"></a>
+<h2 class="shortcontents-heading">Short Table of Contents</h2>
- <div class="shortcontents">
-<h2>Short Contents</h2>
-<ul>
-<a href="#Top">ntpdc: NTPD Control User Manual</a>
+<div class="shortcontents">
+<ul class="no-bullet">
+<li><a name="stoc-Description" href="#toc-Description">1 Description</a></li>
</ul>
</div>
-<ul class="menu">
-<li><a accesskey="1" href="#ntpdc-Description">ntpdc Description</a>: Description
-<li><a accesskey="2" href="#ntpdc-Invocation">ntpdc Invocation</a>: Invoking ntpdc
-<li><a accesskey="3" href="#Usage">Usage</a>: Usage
-</ul>
-
-<div class="node">
-<a name="ntpdc-Description"></a>
-<p><hr>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• <a href="#ntpdc-Description" accesskey="1">ntpdc Description</a>:</td><td> </td><td align="left" valign="top">Description
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpdc-Invocation" accesskey="2">ntpdc Invocation</a>:</td><td> </td><td align="left" valign="top">Invoking ntpdc
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#Usage" accesskey="3">Usage</a>:</td><td> </td><td align="left" valign="top">Usage
+</td></tr>
+</table>
+<hr>
+<a name="ntpdc-Description"></a>
+<div class="header">
+<p>
+Next: <a href="#ntpdc-Invocation" accesskey="n" rel="next">ntpdc Invocation</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> </p>
</div>
-
-<!-- node-name, next, previous, up -->
-<h3 class="section">Description</h3>
+<a name="Description"></a>
+<h2 class="chapter">1 Description</h2>
<p>By default, <code>ntpdc</code> writes the local data and time (i.e., not UTC) to the
standard output in the format:
+</p>
+<div class="example">
+<pre class="example">1996-10-15 20:17:25.123 (+0800) +4.567 +/- 0.089 secs
+</pre></div>
-<pre class="example"> 1996-10-15 20:17:25.123 (+0800) +4.567 +/- 0.089 secs
-</pre>
- <p>where
+<p>where
YYYY-MM-DD HH:MM:SS.SUBSEC is the local date and time,
(+0800) is the local timezone adjustment (so we would add 8 hours and 0 minutes to convert the reported local time to UTC),
and
the +4.567 +/- 0.089 secs indicates the time offset and
error bound of the system clock relative to the server clock.
-
-<div class="node">
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• <a href="#ntpdc-Invocation" accesskey="1">ntpdc Invocation</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#Usage" accesskey="2">Usage</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+</table>
+
+<hr>
<a name="ntpdc-Invocation"></a>
-<p><hr>
-
-
+<div class="header">
+<p>
+Next: <a href="#Usage" accesskey="n" rel="next">Usage</a>, Previous: <a href="#ntpdc-Description" accesskey="p" rel="prev">ntpdc Description</a>, Up: <a href="#ntpdc-Description" accesskey="u" rel="up">ntpdc Description</a> </p>
</div>
+<a name="Invoking-ntpdc"></a>
+<h3 class="section">1.1 Invoking ntpdc</h3>
+<a name="index-ntpdc"></a>
+<a name="index-vendor_002dspecific-NTPD-control-program"></a>
-<h3 class="section">Invoking ntpdc</h3>
-<p><a name="index-ntpdc-1"></a><a name="index-vendor_002dspecific-NTPD-control-program-2"></a>
-is deprecated.
+<p><code>ntpdc</code>
+is deprecated.
Please use
<code>ntpq(1ntpqmdoc)</code> instead - it can do everything
<code>ntpdc</code>
used to do, and it does so using a much more sane interface.
-
+</p>
+<p><code>ntpdc</code>
is a utility program used to query
<code>ntpd(1ntpdmdoc)</code>
about its
-current state and to request changes in that state.
-It uses NTP mode 7 control message formats described in the source code.
+current state and to request changes in that state.
+It uses NTP mode 7 control message formats described in the source code.
The program may
be run either in interactive mode or controlled using command line
-arguments.
+arguments.
Extensive state and statistics information is available
through the
<code>ntpdc</code>
-interface.
+interface.
In addition, nearly all the
configuration options which can be specified at startup using
-ntpd's configuration file may also be specified at run time using
+ntpd’s configuration file may also be specified at run time using
<code>ntpdc</code>
-
-
<p>This section was generated by <strong>AutoGen</strong>,
-using the <code>agtexi-cmd</code> template and the option descriptions for the <code>ntpdc</code> program.
+</p>
+<p>This section was generated by <strong>AutoGen</strong>,
+using the <code>agtexi-cmd</code> template and the option descriptions for the <code>ntpdc</code> program.
This software is released under the NTP license, <http://ntp.org/license>.
-
-<ul class="menu">
-<li><a accesskey="1" href="#ntpdc-usage">ntpdc usage</a>: ntpdc help/usage (<samp><span class="option">--help</span></samp>)
-<li><a accesskey="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)
-<li><a accesskey="5" href="#ntpdc-interactive">ntpdc interactive</a>: interactive option (-i)
-<li><a accesskey="6" href="#ntpdc-listpeers">ntpdc listpeers</a>: listpeers option (-l)
-<li><a accesskey="7" href="#ntpdc-numeric">ntpdc numeric</a>: numeric option (-n)
-<li><a accesskey="8" href="#ntpdc-peers">ntpdc peers</a>: peers option (-p)
-<li><a accesskey="9" href="#ntpdc-showpeers">ntpdc showpeers</a>: showpeers option (-s)
-<li><a href="#ntpdc-config">ntpdc config</a>: presetting/configuring ntpdc
-<li><a href="#ntpdc-exit-status">ntpdc exit status</a>: exit status
-<li><a href="#ntpdc-Usage">ntpdc Usage</a>: Usage
-<li><a href="#ntpdc-See-Also">ntpdc See Also</a>: See Also
-<li><a href="#ntpdc-Authors">ntpdc Authors</a>: Authors
-<li><a href="#ntpdc-Bugs">ntpdc Bugs</a>: Bugs
-</ul>
-
-<div class="node">
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• <a href="#ntpdc-usage" accesskey="1">ntpdc usage</a>:</td><td> </td><td align="left" valign="top">ntpdc help/usage (<samp>--help</samp>)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpdc-ipv4" accesskey="2">ntpdc ipv4</a>:</td><td> </td><td align="left" valign="top">ipv4 option (-4)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpdc-ipv6" accesskey="3">ntpdc ipv6</a>:</td><td> </td><td align="left" valign="top">ipv6 option (-6)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpdc-command" accesskey="4">ntpdc command</a>:</td><td> </td><td align="left" valign="top">command option (-c)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpdc-interactive" accesskey="5">ntpdc interactive</a>:</td><td> </td><td align="left" valign="top">interactive option (-i)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpdc-listpeers" accesskey="6">ntpdc listpeers</a>:</td><td> </td><td align="left" valign="top">listpeers option (-l)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpdc-numeric" accesskey="7">ntpdc numeric</a>:</td><td> </td><td align="left" valign="top">numeric option (-n)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpdc-peers" accesskey="8">ntpdc peers</a>:</td><td> </td><td align="left" valign="top">peers option (-p)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpdc-showpeers" accesskey="9">ntpdc showpeers</a>:</td><td> </td><td align="left" valign="top">showpeers option (-s)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpdc-config">ntpdc config</a>:</td><td> </td><td align="left" valign="top">presetting/configuring ntpdc
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpdc-exit-status">ntpdc exit status</a>:</td><td> </td><td align="left" valign="top">exit status
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpdc-Usage">ntpdc Usage</a>:</td><td> </td><td align="left" valign="top">Usage
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpdc-See-Also">ntpdc See Also</a>:</td><td> </td><td align="left" valign="top">See Also
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpdc-Authors">ntpdc Authors</a>:</td><td> </td><td align="left" valign="top">Authors
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpdc-Bugs">ntpdc Bugs</a>:</td><td> </td><td align="left" valign="top">Bugs
+</td></tr>
+</table>
+
+<hr>
<a name="ntpdc-usage"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-ipv4">ntpdc ipv4</a>,
-Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<div class="header">
+<p>
+Next: <a href="#ntpdc-ipv4" accesskey="n" rel="next">ntpdc ipv4</a>, Up: <a href="#ntpdc-Invocation" accesskey="u" rel="up">ntpdc Invocation</a> </p>
</div>
-
-<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
-(<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.
+<a name="ntpdc-help_002fusage-_0028_002d_002dhelp_0029"></a>
+<h4 class="subsection">1.1.1 ntpdc help/usage (<samp>--help</samp>)</h4>
+<a name="index-ntpdc-help"></a>
+
+<p>This is the automatically generated usage text for ntpdc.
+</p>
+<p>The text printed is the same whether selected with the <code>help</code> option
+(<samp>--help</samp>) or the <code>more-help</code> option (<samp>--more-help</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 <samp><span class="file">more</span></samp>. Both will exit
+used to select the program, defaulting to <samp>more</samp>. Both will exit
with a status code of 0.
-
+</p>
+<div class="example">
<pre class="example">ntpdc - vendor-specific NTPD control program - Ver. 4.2.8p13
Usage: ntpdc [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]
Flg Arg Option-Name Description
- examining environment variables named NTPDC_*
Please send bug reports to: <http://bugs.ntp.org, bugs@ntp.org>
-</pre>
- <div class="node">
-<a name="ntpdc-ipv4"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-ipv6">ntpdc ipv6</a>,
-Previous: <a rel="previous" accesskey="p" href="#ntpdc-usage">ntpdc usage</a>,
-Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
+</pre></div>
+<hr>
+<a name="ntpdc-ipv4"></a>
+<div class="header">
+<p>
+Next: <a href="#ntpdc-ipv6" accesskey="n" rel="next">ntpdc ipv6</a>, Previous: <a href="#ntpdc-usage" accesskey="p" rel="prev">ntpdc usage</a>, Up: <a href="#ntpdc-Invocation" accesskey="u" rel="up">ntpdc Invocation</a> </p>
</div>
-
-<h4 class="subsection">ipv4 option (-4)</h4>
-
-<p><a name="index-ntpdc_002dipv4-4"></a>
-This is the “force ipv4 dns name resolution” option.
-
-<p class="noindent">This option has some usage constraints. It:
-<li>must not appear in combination with any of the following options:
-ipv6.
-</ul>
-
-
<p>Force DNS resolution of following host names on the command line
-to the IPv4 namespace.
-<div class="node">
+<a name="ipv4-option-_0028_002d4_0029"></a>
+<h4 class="subsection">1.1.2 ipv4 option (-4)</h4>
+<a name="index-ntpdc_002dipv4"></a>
+
+<p>This is the “force ipv4 dns name resolution” option.
+</p>
+<p>This option has some usage constraints. It:
+<li> must not appear in combination with any of the following options:
+ipv6.
+</li></ul>
+
+<p>Force DNS resolution of following host names on the command line
+to the IPv4 namespace.
+</p><hr>
<a name="ntpdc-ipv6"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntpdc-command" accesskey="n" rel="next">ntpdc command</a>, Previous: <a href="#ntpdc-ipv4" accesskey="p" rel="prev">ntpdc ipv4</a>, Up: <a href="#ntpdc-Invocation" accesskey="u" rel="up">ntpdc Invocation</a> </p>
</div>
-
-<h4 class="subsection">ipv6 option (-6)</h4>
-
-<p><a name="index-ntpdc_002dipv6-5"></a>
-This is the “force ipv6 dns name resolution” option.
-
-<p class="noindent">This option has some usage constraints. It:
-<li>must not appear in combination with any of the following options:
-ipv4.
-</ul>
-
-
<p>Force DNS resolution of following host names on the command line
-to the IPv6 namespace.
-<div class="node">
+<a name="ipv6-option-_0028_002d6_0029"></a>
+<h4 class="subsection">1.1.3 ipv6 option (-6)</h4>
+<a name="index-ntpdc_002dipv6"></a>
+
+<p>This is the “force ipv6 dns name resolution” option.
+</p>
+<p>This option has some usage constraints. It:
+<li> must not appear in combination with any of the following options:
+ipv4.
+</li></ul>
+
+<p>Force DNS resolution of following host names on the command line
+to the IPv6 namespace.
+</p><hr>
<a name="ntpdc-command"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntpdc-interactive" accesskey="n" rel="next">ntpdc interactive</a>, Previous: <a href="#ntpdc-ipv6" accesskey="p" rel="prev">ntpdc ipv6</a>, Up: <a href="#ntpdc-Invocation" accesskey="u" rel="up">ntpdc Invocation</a> </p>
</div>
-
-<h4 class="subsection">command option (-c)</h4>
-
-<p><a name="index-ntpdc_002dcommand-6"></a>
-This is the “run a command and exit” option.
-This option takes a string argument <samp><span class="file">cmd</span></samp>.
-
-<p class="noindent">This option has some usage constraints. It:
-<li>may appear an unlimited number of times.
-</ul>
-
-
<p>The following argument is interpreted as an interactive format command
+<a name="command-option-_0028_002dc_0029"></a>
+<h4 class="subsection">1.1.4 command option (-c)</h4>
+<a name="index-ntpdc_002dcommand"></a>
+
+<p>This is the “run a command and exit” option.
+This option takes a string argument <samp>cmd</samp>.
+</p>
+<p>This option has some usage constraints. It:
+<li> may appear an unlimited number of times.
+</li></ul>
+
+<p>The following argument is interpreted as an interactive format command
and is added to the list of commands to be executed on the specified
-host(s).
-<div class="node">
+host(s).
+</p><hr>
<a name="ntpdc-interactive"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntpdc-listpeers" accesskey="n" rel="next">ntpdc listpeers</a>, Previous: <a href="#ntpdc-command" accesskey="p" rel="prev">ntpdc command</a>, Up: <a href="#ntpdc-Invocation" accesskey="u" rel="up">ntpdc Invocation</a> </p>
</div>
-
-<h4 class="subsection">interactive option (-i)</h4>
-
-<p><a name="index-ntpdc_002dinteractive-7"></a>
-This is the “force ntpq to operate in interactive mode” option.
-
-<p class="noindent">This option has some usage constraints. It:
-<li>must not appear in combination with any of the following options:
-command, listpeers, peers, showpeers.
-</ul>
-
-
<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="interactive-option-_0028_002di_0029"></a>
+<h4 class="subsection">1.1.5 interactive option (-i)</h4>
+<a name="index-ntpdc_002dinteractive"></a>
+
+<p>This is the “force ntpq to operate in interactive mode” option.
+</p>
+<p>This option has some usage constraints. It:
+<li> must not appear in combination with any of the following options:
+command, listpeers, peers, showpeers.
+</li></ul>
+
+<p>Force ntpq to operate in interactive mode. Prompts will be written
+to the standard output and commands read from the standard input.
+</p><hr>
<a name="ntpdc-listpeers"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntpdc-numeric" accesskey="n" rel="next">ntpdc numeric</a>, Previous: <a href="#ntpdc-interactive" accesskey="p" rel="prev">ntpdc interactive</a>, Up: <a href="#ntpdc-Invocation" accesskey="u" rel="up">ntpdc Invocation</a> </p>
</div>
-
-<h4 class="subsection">listpeers option (-l)</h4>
-
-<p><a name="index-ntpdc_002dlistpeers-8"></a>
-This is the “print a list of the peers” option.
-
-<p class="noindent">This option has some usage constraints. It:
-<li>must not appear in combination with any of the following options:
-command.
-</ul>
-
-
<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="listpeers-option-_0028_002dl_0029"></a>
+<h4 class="subsection">1.1.6 listpeers option (-l)</h4>
+<a name="index-ntpdc_002dlistpeers"></a>
+
+<p>This is the “print a list of the peers” option.
+</p>
+<p>This option has some usage constraints. It:
+<li> must not appear in combination with any of the following options:
+command.
+</li></ul>
+
+<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.
+</p><hr>
<a name="ntpdc-numeric"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntpdc-peers" accesskey="n" rel="next">ntpdc peers</a>, Previous: <a href="#ntpdc-listpeers" accesskey="p" rel="prev">ntpdc listpeers</a>, Up: <a href="#ntpdc-Invocation" accesskey="u" rel="up">ntpdc Invocation</a> </p>
</div>
+<a name="numeric-option-_0028_002dn_0029"></a>
+<h4 class="subsection">1.1.7 numeric option (-n)</h4>
+<a name="index-ntpdc_002dnumeric"></a>
-<h4 class="subsection">numeric option (-n)</h4>
-
-<p><a name="index-ntpdc_002dnumeric-9"></a>
-This is the “numeric host addresses” option.
+<p>This is the “numeric host addresses” option.
Output all host addresses in dotted-quad numeric format rather than
converting to the canonical host names.
-<div class="node">
+</p><hr>
<a name="ntpdc-peers"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntpdc-showpeers" accesskey="n" rel="next">ntpdc showpeers</a>, Previous: <a href="#ntpdc-numeric" accesskey="p" rel="prev">ntpdc numeric</a>, Up: <a href="#ntpdc-Invocation" accesskey="u" rel="up">ntpdc Invocation</a> </p>
</div>
-
-<h4 class="subsection">peers option (-p)</h4>
-
-<p><a name="index-ntpdc_002dpeers-10"></a>
-This is the “print a list of the peers” option.
-
-<p class="noindent">This option has some usage constraints. It:
-<li>must not appear in combination with any of the following options:
-command.
-</ul>
-
-
<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="peers-option-_0028_002dp_0029"></a>
+<h4 class="subsection">1.1.8 peers option (-p)</h4>
+<a name="index-ntpdc_002dpeers"></a>
+
+<p>This is the “print a list of the peers” option.
+</p>
+<p>This option has some usage constraints. It:
+<li> must not appear in combination with any of the following options:
+command.
+</li></ul>
+
+<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.
+</p><hr>
<a name="ntpdc-showpeers"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntpdc-config" accesskey="n" rel="next">ntpdc config</a>, Previous: <a href="#ntpdc-peers" accesskey="p" rel="prev">ntpdc peers</a>, Up: <a href="#ntpdc-Invocation" accesskey="u" rel="up">ntpdc Invocation</a> </p>
</div>
-
-<h4 class="subsection">showpeers option (-s)</h4>
-
-<p><a name="index-ntpdc_002dshowpeers-11"></a>
-This is the “show a list of the peers” option.
-
-<p class="noindent">This option has some usage constraints. It:
- <ul>
-<li>must not appear in combination with any of the following options:
-command.
-</ul>
-
- <p>Print a list of the peers known to the server as well as a summary
-of their state. This is equivalent to the 'dmpeers' interactive command.
-
-<div class="node">
+<a name="showpeers-option-_0028_002ds_0029"></a>
+<h4 class="subsection">1.1.9 showpeers option (-s)</h4>
+<a name="index-ntpdc_002dshowpeers"></a>
+
+<p>This is the “show a list of the peers” option.
+</p>
+<p>This option has some usage constraints. It:
+</p><ul>
+<li> must not appear in combination with any of the following options:
+command.
+</li></ul>
+
+<p>Print a list of the peers known to the server as well as a summary
+of their state. This is equivalent to the ’dmpeers’ interactive command.
+</p>
+
+<hr>
<a name="ntpdc-config"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntpdc-exit-status" accesskey="n" rel="next">ntpdc exit status</a>, Previous: <a href="#ntpdc-showpeers" accesskey="p" rel="prev">ntpdc showpeers</a>, Up: <a href="#ntpdc-Invocation" accesskey="u" rel="up">ntpdc Invocation</a> </p>
</div>
-
-<h4 class="subsection">presetting/configuring ntpdc</h4>
+<a name="presetting_002fconfiguring-ntpdc"></a>
+<h4 class="subsection">1.1.10 presetting/configuring ntpdc</h4>
<p>Any option that is not marked as <i>not presettable</i> may be preset by
-loading values from configuration ("rc" or "ini") files, and values from environment variables named <code>NTPDC</code> and <code>NTPDC_<OPTION_NAME></code>. <code><OPTION_NAME></code> must be one of
-the options listed above in upper case and segmented with underscores.
+loading values from configuration ("rc" or "ini") files, and values from environment variables named <code>NTPDC</code> and <code>NTPDC_<OPTION_NAME></code>. <code><OPTION_NAME></code> must be one of
+the options listed above in upper case and segmented with underscores.
The <code>NTPDC</code> variable will be tokenized and parsed like
the command line. The remaining variables are tested for existence and their
values are treated like option arguments.
-
-<p class="noindent"><code>libopts</code> will search in 2 places for configuration files:
- <ul>
-<li>$HOME
-<li>$PWD
-</ul>
- The environment variables <code>HOME</code>, and <code>PWD</code>
-are expanded and replaced when <samp><span class="file">ntpdc</span></samp> runs.
-For any of these that are plain files, they are simply processed.
-For any that are directories, then a file named <samp><span class="file">.ntprc</span></samp> is searched for
+</p>
+
+<p><code>libopts</code> will search in 2 places for configuration files:
+</p><ul>
+<li> $HOME
+</li><li> $PWD
+</li></ul>
+<p>The environment variables <code>HOME</code>, and <code>PWD</code>
+are expanded and replaced when <samp>ntpdc</samp> runs.
+For any of these that are plain files, they are simply processed.
+For any that are directories, then a file named <samp>.ntprc</samp> is searched for
within that directory and processed.
-
- <p>Configuration files may be in a wide variety of formats.
+</p>
+<p>Configuration files may be in a wide variety of formats.
The basic format is an option name followed by a value (argument) on the
same line. Values may be separated from the option name with a colon,
equal sign or simply white space. Values may be continued across multiple
lines by escaping the newline with a backslash.
-
- <p>Multiple programs may also share the same initialization file.
+</p>
+<p>Multiple programs may also share the same initialization file.
Common options are collected at the top, followed by program specific
segments. The segments are separated by lines like:
-<pre class="example"> [NTPDC]
-</pre>
- <p class="noindent">or by
-<pre class="example"> <?program ntpdc>
-</pre>
- <p class="noindent">Do not mix these styles within one configuration file.
-
- <p>Compound values and carefully constructed string values may also be
+</p><div class="example">
+<pre class="example">[NTPDC]
+</pre></div>
+<p>or by
+</p><div class="example">
+<pre class="example"><?program ntpdc>
+</pre></div>
+<p>Do not mix these styles within one configuration file.
+</p>
+<p>Compound values and carefully constructed string values may also be
specified using XML syntax:
-<pre class="example"> <option-name>
- <sub-opt>...&lt;...&gt;...</sub-opt>
- </option-name>
-</pre>
- <p class="noindent">yielding an <code>option-name.sub-opt</code> string value of
-<pre class="example"> "...<...>..."
-</pre>
- <p><code>AutoOpts</code> does not track suboptions. You simply note that it is a
+</p><div class="example">
+<pre class="example"><option-name>
+ <sub-opt>...&lt;...&gt;...</sub-opt>
+</option-name>
+</pre></div>
+<p>yielding an <code>option-name.sub-opt</code> string value of
+</p><div class="example">
+<pre class="example">"...<...>..."
+</pre></div>
+<p><code>AutoOpts</code> does not track suboptions. You simply note that it is a
hierarchicly valued option. <code>AutoOpts</code> does provide a means for searching
the associated name/value pair list (see: optionFindValue).
-
- <p>The command line options relating to configuration and/or usage help are:
-
-<h5 class="subsubheading">version (-)</h5>
+</p>
+<p>The command line options relating to configuration and/or usage help are:
+</p>
+<a name="version-_0028_002d_0029"></a>
+<h4 class="subsubheading">version (-)</h4>
<p>Print the program version to standard out, optionally with licensing
information, then exit 0. The optional argument specifies how much licensing
-detail to provide. The default is to print just the version. The licensing infomation may be selected with an option argument.
+detail to provide. The default is to print just the version. The licensing infomation may be selected with an option argument.
Only the first letter of the argument is examined:
-
- <dl>
-<dt>‘<samp><span class="samp">version</span></samp>’<dd>Only print the version. This is the default.
-<br><dt>‘<samp><span class="samp">copyright</span></samp>’<dd>Name the copyright usage licensing terms.
-<br><dt>‘<samp><span class="samp">verbose</span></samp>’<dd>Print the full copyright usage licensing terms.
+</p>
+<dl compact="compact">
+<dt>‘<samp>version</samp>’</dt>
+<dd><p>Only print the version. This is the default.
+</p></dd>
+<dt>‘<samp>copyright</samp>’</dt>
+<dd><p>Name the copyright usage licensing terms.
+</p></dd>
+<dt>‘<samp>verbose</samp>’</dt>
+<dd><p>Print the full copyright usage licensing terms.
+</p></dd>
</dl>
-<div class="node">
+<hr>
<a name="ntpdc-exit-status"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntpdc-Usage" accesskey="n" rel="next">ntpdc Usage</a>, Previous: <a href="#ntpdc-config" accesskey="p" rel="prev">ntpdc config</a>, Up: <a href="#ntpdc-Invocation" accesskey="u" rel="up">ntpdc Invocation</a> </p>
</div>
-
-<h4 class="subsection">ntpdc exit status</h4>
+<a name="ntpdc-exit-status-1"></a>
+<h4 class="subsection">1.1.11 ntpdc exit status</h4>
<p>One of the following exit values will be returned:
- <dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
-<br><dt>‘<samp><span class="samp">66 (EX_NOINPUT)</span></samp>’<dd>A specified configuration file could not be loaded.
-<br><dt>‘<samp><span class="samp">70 (EX_SOFTWARE)</span></samp>’<dd>libopts had an internal operational error. Please report
-it to autogen-users@lists.sourceforge.net. Thank you.
+</p><dl compact="compact">
+<dt>‘<samp>0 (EXIT_SUCCESS)</samp>’</dt>
+<dd><p>Successful program execution.
+</p></dd>
+<dt>‘<samp>1 (EXIT_FAILURE)</samp>’</dt>
+<dd><p>The operation failed or the command syntax was not valid.
+</p></dd>
+<dt>‘<samp>66 (EX_NOINPUT)</samp>’</dt>
+<dd><p>A specified configuration file could not be loaded.
+</p></dd>
+<dt>‘<samp>70 (EX_SOFTWARE)</samp>’</dt>
+<dd><p>libopts had an internal operational error. Please report
+it to autogen-users@lists.sourceforge.net. Thank you.
+</p></dd>
</dl>
- <div class="node">
+<hr>
<a name="ntpdc-Usage"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntpdc-See-Also" accesskey="n" rel="next">ntpdc See Also</a>, Previous: <a href="#ntpdc-exit-status" accesskey="p" rel="prev">ntpdc exit status</a>, Up: <a href="#ntpdc-Invocation" accesskey="u" rel="up">ntpdc Invocation</a> </p>
</div>
-
-<h4 class="subsection">ntpdc Usage</h4>
-
-<div class="node">
+<a name="ntpdc-Usage-1"></a>
+<h4 class="subsection">1.1.12 ntpdc Usage</h4>
+<hr>
<a name="ntpdc-See-Also"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntpdc-Authors" accesskey="n" rel="next">ntpdc Authors</a>, Previous: <a href="#ntpdc-Usage" accesskey="p" rel="prev">ntpdc Usage</a>, Up: <a href="#ntpdc-Invocation" accesskey="u" rel="up">ntpdc Invocation</a> </p>
</div>
-
-<h4 class="subsection">ntpdc See Also</h4>
-
-<div class="node">
+<a name="ntpdc-See-Also-1"></a>
+<h4 class="subsection">1.1.13 ntpdc See Also</h4>
+<hr>
<a name="ntpdc-Authors"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntpdc-Bugs" accesskey="n" rel="next">ntpdc Bugs</a>, Previous: <a href="#ntpdc-See-Also" accesskey="p" rel="prev">ntpdc See Also</a>, Up: <a href="#ntpdc-Invocation" accesskey="u" rel="up">ntpdc Invocation</a> </p>
</div>
-
-<h4 class="subsection">ntpdc Authors</h4>
-
-<div class="node">
+<a name="ntpdc-Authors-1"></a>
+<h4 class="subsection">1.1.14 ntpdc Authors</h4>
+<hr>
<a name="ntpdc-Bugs"></a>
-<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#ntpdc-Authors">ntpdc Authors</a>,
-Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<div class="header">
+<p>
+Previous: <a href="#ntpdc-Authors" accesskey="p" rel="prev">ntpdc Authors</a>, Up: <a href="#ntpdc-Invocation" accesskey="u" rel="up">ntpdc Invocation</a> </p>
</div>
+<a name="ntpdc-Bugs-1"></a>
+<h4 class="subsection">1.1.15 ntpdc Bugs</h4>
-<h4 class="subsection">ntpdc Bugs</h4>
-
-<div class="node">
+<hr>
<a name="Usage"></a>
-<p><hr>
-
-
+<div class="header">
+<p>
+Previous: <a href="#ntpdc-Invocation" accesskey="p" rel="prev">ntpdc Invocation</a>, Up: <a href="#ntpdc-Description" accesskey="u" rel="up">ntpdc Description</a> </p>
</div>
-
-<!-- node-name, next, previous, up -->
-<h3 class="section">Usage</h3>
+<a name="Usage-1"></a>
+<h3 class="section">1.2 Usage</h3>
<p>The simplest use of this program is as an unprivileged command to
-check the current time, offset, and error in the local clock.
+check the current time, offset, and error in the local clock.
For example:
+</p>
+<div class="example">
+<pre class="example">ntpdc ntpserver.somewhere
+</pre></div>
-<pre class="example"> ntpdc ntpserver.somewhere
-</pre>
- <p>With suitable privilege, it can be run as a command or in a
+<p>With suitable privilege, it can be run as a command or in a
<code>cron</code> job to reset the local clock from a reliable server, like
-the <code>ntpdate</code> and <code>rdate</code> commands.
+the <code>ntpdate</code> and <code>rdate</code> commands.
For example:
+</p>
+<div class="example">
+<pre class="example">ntpdc -a ntpserver.somewhere
+</pre></div>
+<hr>
+
-<pre class="example"> ntpdc -a ntpserver.somewhere
-</pre>
- </body></html>
+</body>
+</html>
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntpdc @NTPDC_MS@ "04 Feb 2020" "4.2.8p13" "User Commands"
+.TH ntpdc @NTPDC_MS@ "03 Mar 2020" "4.2.8p13" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:14 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:36:01 PM by AutoGen 5.18.5
.\" From the definitions ntpdc-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt NTPDC @NTPDC_MS@ User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntpdc-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:11 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:35:58 PM by AutoGen 5.18.5
.\" From the definitions ntpdc-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-ntpq.texi)
#
-# It has been AutoGen-ed February 4, 2020 at 11:53:27 PM by AutoGen 5.18.5
+# It has been AutoGen-ed March 3, 2020 at 04:36:09 PM by AutoGen 5.18.5
# From the definitions ntpq-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
/*
* EDIT THIS FILE WITH CAUTION (ntpq-opts.c)
*
- * It has been AutoGen-ed February 4, 2020 at 11:53:16 PM by AutoGen 5.18.5
+ * It has been AutoGen-ed March 3, 2020 at 04:36:02 PM by AutoGen 5.18.5
* From the definitions ntpq-opts.def
* and the template file options
*
- * Generated from AutoOpts 41:0:16 templates.
+ * Generated from AutoOpts 41:1:16 templates.
*
* AutoOpts is a copyrighted work. This source file is not encumbered
* by AutoOpts licensing, but is provided under the licensing terms chosen
/*
* EDIT THIS FILE WITH CAUTION (ntpq-opts.h)
*
- * It has been AutoGen-ed February 4, 2020 at 11:53:16 PM by AutoGen 5.18.5
+ * It has been AutoGen-ed March 3, 2020 at 04:36:02 PM by AutoGen 5.18.5
* From the definitions ntpq-opts.def
* and the template file options
*
- * Generated from AutoOpts 41:0:16 templates.
+ * Generated from AutoOpts 41:1:16 templates.
*
* AutoOpts is a copyrighted work. This header file is not encumbered
* by AutoOpts licensing, but is provided under the licensing terms chosen
* tolerable version is at least as old as what was current when the header
* template was released.
*/
-#define AO_TEMPLATE_VERSION 167936
+#define AO_TEMPLATE_VERSION 167937
#if (AO_TEMPLATE_VERSION < OPTIONS_MINIMUM_VERSION) \
|| (AO_TEMPLATE_VERSION > OPTIONS_STRUCT_VERSION)
# error option template version mismatches autoopts/options.h header
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntpq 1ntpqman "04 Feb 2020" "4.2.8p13" "User Commands"
+.TH ntpq 1ntpqman "03 Mar 2020" "4.2.8p13" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:28 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:36:10 PM by AutoGen 5.18.5
.\" From the definitions ntpq-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt NTPQ 1ntpqmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntpq-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:25 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:36:07 PM by AutoGen 5.18.5
.\" From the definitions ntpq-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
with a status code of 0.
</p>
<div class="example">
-<pre class="example">ntpq - standard NTP query program - Ver. 4.2.8p13
+<pre class="example">ntpq - standard NTP query program - Ver. 4.2.8p13-foo
Usage: ntpq [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]
Flg Arg Option-Name Description
-4 no ipv4 Force IPv4 name resolution
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntpq @NTPQ_MS@ "04 Feb 2020" "4.2.8p13" "User Commands"
+.TH ntpq @NTPQ_MS@ "03 Mar 2020" "4.2.8p13" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:28 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:36:10 PM by AutoGen 5.18.5
.\" From the definitions ntpq-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt NTPQ @NTPQ_MS@ User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntpq-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:25 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:36:07 PM by AutoGen 5.18.5
.\" From the definitions ntpq-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-ntpsnmpd.texi)
#
-# It has been AutoGen-ed February 4, 2020 at 11:53:33 PM by AutoGen 5.18.5
+# It has been AutoGen-ed March 3, 2020 at 04:36:14 PM by AutoGen 5.18.5
# From the definitions ntpsnmpd-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
/*
* EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.c)
*
- * It has been AutoGen-ed February 4, 2020 at 11:53:29 PM by AutoGen 5.18.5
+ * It has been AutoGen-ed March 3, 2020 at 04:36:12 PM by AutoGen 5.18.5
* From the definitions ntpsnmpd-opts.def
* and the template file options
*
- * Generated from AutoOpts 41:0:16 templates.
+ * Generated from AutoOpts 41:1:16 templates.
*
* AutoOpts is a copyrighted work. This source file is not encumbered
* by AutoOpts licensing, but is provided under the licensing terms chosen
/*
* EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.h)
*
- * It has been AutoGen-ed February 4, 2020 at 11:53:29 PM by AutoGen 5.18.5
+ * It has been AutoGen-ed March 3, 2020 at 04:36:12 PM by AutoGen 5.18.5
* From the definitions ntpsnmpd-opts.def
* and the template file options
*
- * Generated from AutoOpts 41:0:16 templates.
+ * Generated from AutoOpts 41:1:16 templates.
*
* AutoOpts is a copyrighted work. This header file is not encumbered
* by AutoOpts licensing, but is provided under the licensing terms chosen
* tolerable version is at least as old as what was current when the header
* template was released.
*/
-#define AO_TEMPLATE_VERSION 167936
+#define AO_TEMPLATE_VERSION 167937
#if (AO_TEMPLATE_VERSION < OPTIONS_MINIMUM_VERSION) \
|| (AO_TEMPLATE_VERSION > OPTIONS_STRUCT_VERSION)
# error option template version mismatches autoopts/options.h header
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntpsnmpd 1ntpsnmpdman "04 Feb 2020" "4.2.8p13" "User Commands"
+.TH ntpsnmpd 1ntpsnmpdman "03 Mar 2020" "4.2.8p13" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:35 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:36:15 PM by AutoGen 5.18.5
.\" From the definitions ntpsnmpd-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt NTPSNMPD 1ntpsnmpdmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:32 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:36:13 PM by AutoGen 5.18.5
.\" From the definitions ntpsnmpd-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntpsnmpd @NTPSNMPD_MS@ "04 Feb 2020" "4.2.8p13" "User Commands"
+.TH ntpsnmpd @NTPSNMPD_MS@ "03 Mar 2020" "4.2.8p13" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:35 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:36:15 PM by AutoGen 5.18.5
.\" From the definitions ntpsnmpd-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt NTPSNMPD @NTPSNMPD_MS@ User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:32 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:36:13 PM by AutoGen 5.18.5
.\" From the definitions ntpsnmpd-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH calc_tickadj 1calc_tickadjman "04 Feb 2020" "ntp (4.2.8p13)" "User Commands"
+.TH calc_tickadj 1calc_tickadjman "03 Mar 2020" "ntp (4.2.8p13-foo)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:06 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:33:51 PM by AutoGen 5.18.5
.\" From the definitions calc_tickadj-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt CALC_TICKADJ 1calc_tickadjmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (calc_tickadj-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:08 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:33:53 PM by AutoGen 5.18.5
.\" From the definitions calc_tickadj-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
-<html lang="en">
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
-<title>calc_tickadj User's Manual</title>
-<meta http-equiv="Content-Type" content="text/html">
-<meta name="description" content="calc_tickadj User's Manual">
-<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">
-<style type="text/css"><!--
- pre.display { font-family:inherit }
- pre.format { font-family:inherit }
- pre.smalldisplay { font-family:inherit; font-size:smaller }
- pre.smallformat { font-family:inherit; font-size:smaller }
- pre.smallexample { font-size:smaller }
- pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family:serif; font-weight:normal; }
- span.sansserif { font-family:sans-serif; font-weight:normal; }
---></style>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<title>calc_tickadj User’s Manual</title>
+
+<meta name="description" content="calc_tickadj User’s Manual">
+<meta name="keywords" content="calc_tickadj User’s Manual">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<link href="#Top" rel="start" title="Top">
+<link href="dir.html#Top" rel="up" title="(dir)">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+blockquote.indentedblock {margin-right: 0em}
+blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
+blockquote.smallquotation {font-size: smaller}
+div.display {margin-left: 3.2em}
+div.example {margin-left: 3.2em}
+div.lisp {margin-left: 3.2em}
+div.smalldisplay {margin-left: 3.2em}
+div.smallexample {margin-left: 3.2em}
+div.smalllisp {margin-left: 3.2em}
+kbd {font-style: oblique}
+pre.display {font-family: inherit}
+pre.format {font-family: inherit}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: inherit; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: inherit; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.nolinebreak {white-space: nowrap}
+span.roman {font-family: initial; font-weight: normal}
+span.sansserif {font-family: sans-serif; font-weight: normal}
+ul.no-bullet {list-style: none}
+-->
+</style>
+
+
</head>
-<body>
-<h1 class="settitle">calc_tickadj User's Manual</h1>
-<div class="node">
-<a name="Top"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#calc_005ftickadj-Description">calc_tickadj Description</a>,
-Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>,
-Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
-</div>
+<body lang="en">
+<h1 class="settitle" align="center">calc_tickadj User’s Manual</h1>
-<h2 class="unnumbered">calc_tickadj User's Manual</h2>
-<p>This document describes the use of the NTP Project's <code>calc_tickadj</code> program.
-This document applies to version 4.2.8p13 of <code>calc_tickadj</code>.
- <div class="shortcontents">
-<h2>Short Contents</h2>
-<ul>
-<a href="#Top">calc_tickadj User's Manual</a>
+
+<a name="Top"></a>
+<div class="header">
+<p>
+Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> </p>
+</div>
+<a name="calc_005ftickadj-User_0027s-Manual"></a>
+<h1 class="top">calc_tickadj User’s Manual</h1>
+
+<p>This document describes the use of the NTP Project’s <code>calc_tickadj</code> program.
+This document applies to version 4.2.8p13-foo of <code>calc_tickadj</code>.
+</p>
+<a name="SEC_Overview"></a>
+<h2 class="shortcontents-heading">Short Table of Contents</h2>
+
+<div class="shortcontents">
+<ul class="no-bullet">
+<li><a name="stoc-Invoking-calc_005ftickadj" href="#toc-Invoking-calc_005ftickadj">1 Invoking calc_tickadj</a></li>
</ul>
</div>
-<ul class="menu">
-<li><a accesskey="1" href="#calc_005ftickadj-Description">calc_tickadj Description</a>: Description
-<li><a accesskey="2" href="#calc_005ftickadj-Invocation">calc_tickadj Invocation</a>: Invoking calc_tickadj
-</ul>
-<div class="node">
-<a name="calc_tickadj-Invocation"></a>
-<a name="calc_005ftickadj-Invocation"></a>
-<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#calc_005ftickadj-Description">calc_tickadj Description</a>,
-Up: <a rel="up" accesskey="u" href="#Top">Top</a>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• calc_tickadj Description:</td><td> </td><td align="left" valign="top">Description
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#calc_005ftickadj-Invocation" accesskey="2">calc_tickadj Invocation</a>:</td><td> </td><td align="left" valign="top">Invoking calc_tickadj
+</td></tr>
+</table>
+<hr>
+<a name="calc_005ftickadj-Invocation"></a>
+<div class="header">
+<p>
+Up: <a href="#Top" accesskey="u" rel="up">Top</a> </p>
</div>
+<a name="Invoking-calc_005ftickadj"></a>
+<h2 class="chapter">1 Invoking calc_tickadj</h2>
+<a name="index-calc_005ftickadj"></a>
+<a name="index-Calculates-_0022optimal_0022-value-for-tick-given-ntp-drift-file_002e"></a>
-<h3 class="section">Invoking calc_tickadj</h3>
-
-<p><a name="index-calc_005ftickadj-1"></a><a name="index-Calculates-_0022optimal_0022-value-for-tick-given-ntp-drift-file_002e-2"></a>
-The <code>calc_tickadj</code> script uses provided ntp drift file to generate optimal
+<p>The <code>calc_tickadj</code> script uses provided ntp drift file to generate optimal
tick value. Generally, ntpd can do better job if the drift value is the
-smallest possible number.
-
- <p>The example output of
-<pre class="example"> $ ./calc_tickadj
- 81.699 (drift)
- 9999 usec; 9999779 nsec
- $ cat /etc/ntp/drift
- -23.159
-</pre>
- <p>means the following. If tick on that box is 10,000, by making the value 9999
-we'll shift the box from its current drift of -23.159 to a drift of 81.699, and
-in doing so we'll speed the clock up a little every second instead of slowing
+smallest possible number.
+</p>
+<p>The example output of
+</p><div class="example">
+<pre class="example">$ ./calc_tickadj
+81.699 (drift)
+9999 usec; 9999779 nsec
+$ cat /etc/ntp/drift
+-23.159
+</pre></div>
+
+<p>means the following. If tick on that box is 10,000, by making the value 9999
+we’ll shift the box from its current drift of -23.159 to a drift of 81.699, and
+in doing so we’ll speed the clock up a little every second instead of slowing
the clock down a little.
-
- <p>If 'tick' on that box is 10,000,000 then by setting it to 9999779 the drift
+</p>
+<p>If ’tick’ on that box is 10,000,000 then by setting it to 9999779 the drift
value will be somewhere around 0.0.
-
-
<p><code>calc_tickadj</code> tries to determine the the tick value by using
-<code>tickadj</code> program from ntp package. If this doesn't work you can specify
+</p>
+<p><code>calc_tickadj</code> tries to determine the the tick value by using
+<code>tickadj</code> program from ntp package. If this doesn’t work you can specify
current tick manually on command line.
+</p>
-
<p>This section was generated by <strong>AutoGen</strong>,
+<p>This section was generated by <strong>AutoGen</strong>,
using the <code>agtexi-cmd</code> template and the option descriptions for the <code>calc_tickadj</code> program.
-
-<ul class="menu">
-<li><a accesskey="1" href="#calc_005ftickadj-usage">calc_tickadj usage</a>: calc_tickadj help/usage (<samp><span class="option">--help</span></samp>)
-<li><a accesskey="2" href="#calc_005ftickadj-drift_002dfile">calc_tickadj drift-file</a>: drift-file option (-d)
-<li><a accesskey="3" href="#calc_005ftickadj-tick">calc_tickadj tick</a>: tick option (-t)
-<li><a accesskey="4" href="#calc_005ftickadj-exit-status">calc_tickadj exit status</a>: exit status
-</ul>
-
-<div class="node">
-<a name="calc_tickadj-usage"></a>
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• <a href="#calc_005ftickadj-usage" accesskey="1">calc_tickadj usage</a>:</td><td> </td><td align="left" valign="top">calc_tickadj help/usage (<samp>--help</samp>)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#calc_005ftickadj-drift_002dfile" accesskey="2">calc_tickadj drift-file</a>:</td><td> </td><td align="left" valign="top">drift-file option (-d)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#calc_005ftickadj-tick" accesskey="3">calc_tickadj tick</a>:</td><td> </td><td align="left" valign="top">tick option (-t)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#calc_005ftickadj-exit-status" accesskey="4">calc_tickadj exit status</a>:</td><td> </td><td align="left" valign="top">exit status
+</td></tr>
+</table>
+
+<hr>
<a name="calc_005ftickadj-usage"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#calc_005ftickadj-drift_002dfile">calc_tickadj drift-file</a>,
-Up: <a rel="up" accesskey="u" href="#calc_005ftickadj-Invocation">calc_tickadj Invocation</a>
-
+<div class="header">
+<p>
+Next: <a href="#calc_005ftickadj-drift_002dfile" accesskey="n" rel="next">calc_tickadj drift-file</a>, Up: <a href="#calc_005ftickadj-Invocation" accesskey="u" rel="up">calc_tickadj Invocation</a> </p>
</div>
-
-<h4 class="subsection">calc_tickadj help/usage (<samp><span class="option">--help</span></samp>)</h4>
-
-<p><a name="index-calc_005ftickadj-help-3"></a>
-This is the automatically generated usage text for calc_tickadj.
-
-
<p>The text printed is the same whether selected with the <code>help</code> option
-(<samp><span class="option">--help</span></samp>) or the <code>more-help</code> option (<samp><span class="option">--more-help</span></samp>). <code>more-help</code> will print
-the usage text by passing it through a pager program.
+<a name="calc_005ftickadj-help_002fusage-_0028_002d_002dhelp_0029"></a>
+<h3 class="section">1.1 calc_tickadj help/usage (<samp>--help</samp>)</h3>
+<a name="index-calc_005ftickadj-help"></a>
+
+<p>This is the automatically generated usage text for calc_tickadj.
+</p>
+<p>The text printed is the same whether selected with the <code>help</code> option
+(<samp>--help</samp>) or the <code>more-help</code> option (<samp>--more-help</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 <samp><span class="file">more</span></samp>. Both will exit
+used to select the program, defaulting to <samp>more</samp>. Both will exit
with a status code of 0.
-
-<pre class="example">calc_tickadj - Calculates "optimal" value for tick given ntp drift file. - Ver. 4.2.7p467
-USAGE: calc_tickadj [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
+</p>
+<div class="example">
+<pre class="example">calc_tickadj - Calculates "optimal" value for tick given ntp drift file. - Ver. 4.2.8p13
+USAGE: calc_tickadj [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
-d, --drift-file=str Ntp drift file to use
-t, --tick=num Tick value of this host
Options are specified by doubled hyphens and their name or by a single
hyphen and the flag character.
-</pre>
- <div class="node">
-<a name="calc_tickadj-drift-file"></a>
+</pre></div>
+
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• <a href="#calc_005ftickadj-drift_002dfile" accesskey="1">calc_tickadj drift-file</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#calc_005ftickadj-tick" accesskey="2">calc_tickadj tick</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#calc_005ftickadj-exit-status" accesskey="3">calc_tickadj exit status</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+</table>
+
+<hr>
<a name="calc_005ftickadj-drift_002dfile"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#calc_005ftickadj-tick">calc_tickadj tick</a>,
-Previous: <a rel="previous" accesskey="p" href="#calc_005ftickadj-usage">calc_tickadj usage</a>,
-Up: <a rel="up" accesskey="u" href="#calc_005ftickadj-Invocation">calc_tickadj Invocation</a>
-
+<div class="header">
+<p>
+Next: <a href="#calc_005ftickadj-tick" accesskey="n" rel="next">calc_tickadj tick</a>, Previous: <a href="#calc_005ftickadj-usage" accesskey="p" rel="prev">calc_tickadj usage</a>, Up: <a href="#calc_005ftickadj-usage" accesskey="u" rel="up">calc_tickadj usage</a> </p>
</div>
+<a name="drift_002dfile-option-_0028_002dd_0029"></a>
+<h4 class="subsection">1.1.1 drift-file option (-d)</h4>
+<a name="index-calc_005ftickadj_002ddrift_002dfile"></a>
-<h4 class="subsection">drift-file option (-d)</h4>
-
-<p><a name="index-calc_005ftickadj_002ddrift_002dfile-4"></a>
-This is the “ntp drift file to use” option.
-This option takes a string argument.
+<p>This is the “ntp drift file to use” option.
+This option takes a string argument.
Use the specified drift file for calculations
-<div class="node">
-<a name="calc_tickadj-tick"></a>
+</p><hr>
<a name="calc_005ftickadj-tick"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#calc_005ftickadj-exit-status">calc_tickadj exit status</a>,
-Previous: <a rel="previous" accesskey="p" href="#calc_005ftickadj-drift_002dfile">calc_tickadj drift-file</a>,
-Up: <a rel="up" accesskey="u" href="#calc_005ftickadj-Invocation">calc_tickadj Invocation</a>
-
+<div class="header">
+<p>
+Next: <a href="#calc_005ftickadj-exit-status" accesskey="n" rel="next">calc_tickadj exit status</a>, Previous: <a href="#calc_005ftickadj-drift_002dfile" accesskey="p" rel="prev">calc_tickadj drift-file</a>, Up: <a href="#calc_005ftickadj-usage" accesskey="u" rel="up">calc_tickadj usage</a> </p>
</div>
+<a name="tick-option-_0028_002dt_0029"></a>
+<h4 class="subsection">1.1.2 tick option (-t)</h4>
+<a name="index-calc_005ftickadj_002dtick"></a>
-<h4 class="subsection">tick option (-t)</h4>
-
-<p><a name="index-calc_005ftickadj_002dtick-5"></a>
-This is the “tick value of this host” option.
-This option takes a number argument.
+<p>This is the “tick value of this host” option.
+This option takes a number argument.
The current tick which to adjustment will be calculated
-<div class="node">
-<a name="calc_tickadj-exit-status"></a>
+</p><hr>
<a name="calc_005ftickadj-exit-status"></a>
-<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#calc_005ftickadj-tick">calc_tickadj tick</a>,
-Up: <a rel="up" accesskey="u" href="#calc_005ftickadj-Invocation">calc_tickadj Invocation</a>
-
+<div class="header">
+<p>
+Previous: <a href="#calc_005ftickadj-tick" accesskey="p" rel="prev">calc_tickadj tick</a>, Up: <a href="#calc_005ftickadj-usage" accesskey="u" rel="up">calc_tickadj usage</a> </p>
</div>
-
-<h4 class="subsection">calc_tickadj exit status</h4>
+<a name="calc_005ftickadj-exit-status-1"></a>
+<h4 class="subsection">1.1.3 calc_tickadj exit status</h4>
<p>One of the following exit values will be returned:
- <dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
+</p><dl compact="compact">
+<dt>‘<samp>0 (EXIT_SUCCESS)</samp>’</dt>
+<dd><p>Successful program execution.
+</p></dd>
+<dt>‘<samp>1 (EXIT_FAILURE)</samp>’</dt>
+<dd><p>The operation failed or the command syntax was not valid.
+</p></dd>
</dl>
+<hr>
+
-</body></html>
+</body>
+</html>
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH calc_tickadj 1calc_tickadjman "04 Feb 2020" "ntp (4.2.8p13)" "User Commands"
+.TH calc_tickadj 1calc_tickadjman "03 Mar 2020" "ntp (4.2.8p13-foo)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:06 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:33:51 PM by AutoGen 5.18.5
.\" From the definitions calc_tickadj-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt CALC_TICKADJ 1calc_tickadjmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (calc_tickadj-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:08 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:33:53 PM by AutoGen 5.18.5
.\" From the definitions calc_tickadj-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-calc_tickadj.texi)
#
-# It has been AutoGen-ed February 4, 2020 at 11:52:09 PM by AutoGen 5.18.5
+# It has been AutoGen-ed March 3, 2020 at 04:33:54 PM by AutoGen 5.18.5
# From the definitions calc_tickadj-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@exampleindent 0
@example
-calc_tickadj - Calculates "optimal" value for tick given ntp drift file. - Ver. 4.2.7p467
+calc_tickadj - Calculates "optimal" value for tick given ntp drift file. - Ver. 4.2.8p13
USAGE: calc_tickadj [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]...
-d, --drift-file=str Ntp drift file to use
#
# EDIT THIS FILE WITH CAUTION (invoke-plot_summary.texi)
#
-# It has been AutoGen-ed February 4, 2020 at 11:52:30 PM by AutoGen 5.18.5
+# It has been AutoGen-ed March 3, 2020 at 04:34:11 PM by AutoGen 5.18.5
# From the definitions plot_summary-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@exampleindent 0
@example
-plot_summary - plot statistics generated by summary script - Ver. 4.2.8p13
+plot_summary - plot statistics generated by summary script - Ver. 4.2.8p13-foo
USAGE: plot_summary [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]...
--directory=str Where the summary files are
#
# EDIT THIS FILE WITH CAUTION (invoke-summary.texi)
#
-# It has been AutoGen-ed February 4, 2020 at 11:52:34 PM by AutoGen 5.18.5
+# It has been AutoGen-ed March 3, 2020 at 04:34:14 PM by AutoGen 5.18.5
# From the definitions summary-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@exampleindent 0
@example
-summary - compute various stastics from NTP stat files - Ver. 4.2.8p13
+summary - compute various stastics from NTP stat files - Ver. 4.2.8p13-foo
USAGE: summary [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]...
--directory=str Directory containing stat files
#
# EDIT THIS FILE WITH CAUTION (invoke-ntp-wait.texi)
#
-# It has been AutoGen-ed February 4, 2020 at 11:52:13 PM by AutoGen 5.18.5
+# It has been AutoGen-ed March 3, 2020 at 04:33:57 PM by AutoGen 5.18.5
# From the definitions ntp-wait-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@exampleindent 0
@example
-ntp-wait - Wait for ntpd to stabilize the system clock - Ver. 4.2.8p13
+ntp-wait - Wait for ntpd to stabilize the system clock - Ver. 4.2.8p13-foo
USAGE: ntp-wait [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]...
-n, --tries=num Number of times to check ntpd
# EDIT THIS FILE WITH CAUTION (ntp-wait-opts)
#
-# It has been AutoGen-ed February 4, 2020 at 11:52:11 PM by AutoGen 5.18.5
+# It has been AutoGen-ed March 3, 2020 at 04:33:55 PM by AutoGen 5.18.5
# From the definitions ntp-wait-opts.def
# and the template file perlopt
'help|?', 'more-help'));
$usage = <<'USAGE';
-ntp-wait - Wait for ntpd to stabilize the system clock - Ver. 4.2.8p13
+ntp-wait - Wait for ntpd to stabilize the system clock - Ver. 4.2.8p13-foo
USAGE: ntp-wait [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
-n, --tries=num Number of times to check ntpd
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntp-wait 1ntp-waitman "04 Feb 2020" "ntp (4.2.8p13)" "User Commands"
+.TH ntp-wait 1ntp-waitman "03 Mar 2020" "ntp (4.2.8p13-foo)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:14 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:33:58 PM by AutoGen 5.18.5
.\" From the definitions ntp-wait-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt NTP_WAIT 1ntp-waitmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntp-wait-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:11 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:33:55 PM by AutoGen 5.18.5
.\" From the definitions ntp-wait-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
-<html lang="en">
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
-<title>Ntp-wait User's Manual</title>
-<meta http-equiv="Content-Type" content="text/html">
-<meta name="description" content="Ntp-wait User's Manual">
-<meta name="generator" content="makeinfo 4.13">
-<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">
-<style type="text/css"><!--
- pre.display { font-family:inherit }
- pre.format { font-family:inherit }
- pre.smalldisplay { font-family:inherit; font-size:smaller }
- pre.smallformat { font-family:inherit; font-size:smaller }
- pre.smallexample { font-size:smaller }
- pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family:serif; font-weight:normal; }
- span.sansserif { font-family:sans-serif; font-weight:normal; }
---></style>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<title>Ntp-wait User’s Manual</title>
+
+<meta name="description" content="Ntp-wait User’s Manual">
+<meta name="keywords" content="Ntp-wait User’s Manual">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<link href="#Top" rel="start" title="Top">
+<link href="dir.html#Top" rel="up" title="(dir)">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+blockquote.indentedblock {margin-right: 0em}
+blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
+blockquote.smallquotation {font-size: smaller}
+div.display {margin-left: 3.2em}
+div.example {margin-left: 3.2em}
+div.lisp {margin-left: 3.2em}
+div.smalldisplay {margin-left: 3.2em}
+div.smallexample {margin-left: 3.2em}
+div.smalllisp {margin-left: 3.2em}
+kbd {font-style: oblique}
+pre.display {font-family: inherit}
+pre.format {font-family: inherit}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: inherit; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: inherit; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.nolinebreak {white-space: nowrap}
+span.roman {font-family: initial; font-weight: normal}
+span.sansserif {font-family: sans-serif; font-weight: normal}
+ul.no-bullet {list-style: none}
+-->
+</style>
+
+
</head>
-<body>
-<h1 class="settitle">Ntp-wait User's Manual</h1>
-<div class="node">
-<a name="Top"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dwait-Description">ntp-wait Description</a>,
-Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>,
-Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
-</div>
+<body lang="en">
+<h1 class="settitle" align="center">Ntp-wait User’s Manual</h1>
+
- <p>This document describes the use of the NTP Project's <code>ntp-wait</code> program.
- <p>If there are time-sensitive applications,
+
+
+<a name="Top"></a>
+<div class="header">
+<p>
+Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> </p>
+</div>
+<h1 class="node-heading">Top</h1>
+
+<p>This document describes the use of the NTP Project’s <code>ntp-wait</code> program.
+</p>
+<p>If there are time-sensitive applications,
the proper sequence of events is to
run <code>ntpd -g</code> as early as possible,
then invoke all of the non-time-sensitive process,
run <code>ntp-wait</code> to block
-until the system's time has stabilized and synchronized,
+until the system’s time has stabilized and synchronized,
and only then start any applicaitons (like database servers) that require
accurate and stable time.
-
- <p>This document applies to version 4.2.8p13 of <code>ntp-wait</code>.
+</p>
+<p>This document applies to version 4.2.8p13-foo of <code>ntp-wait</code>.
+</p>
+<a name="SEC_Overview"></a>
+<h2 class="shortcontents-heading">Short Table of Contents</h2>
<div class="shortcontents">
-<h2>Short Contents</h2>
-<ul>
-</ul>
+<li><a name="stoc-Invoking-ntp_002dwait" href="#toc-Invoking-ntp_002dwait">1 Invoking ntp-wait</a></li>
+
</div>
-<ul class="menu">
-<li><a accesskey="1" href="#ntp_002dwait-Description">ntp-wait Description</a>: Description
-<li><a accesskey="2" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a>: Invoking ntp-wait
-</ul>
-
-<div class="node">
-<a name="ntp-wait-Invocation"></a>
-<a name="ntp_002dwait-Invocation"></a>
-<p><hr>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• ntp-wait Description:</td><td> </td><td align="left" valign="top">Description
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntp_002dwait-Invocation" accesskey="2">ntp-wait Invocation</a>:</td><td> </td><td align="left" valign="top">Invoking ntp-wait
+</td></tr>
+</table>
+<hr>
+<a name="ntp_002dwait-Invocation"></a>
+<div class="header">
+<p>
+Up: <a href="#Top" accesskey="u" rel="up">Top</a> </p>
</div>
+<a name="Invoking-ntp_002dwait"></a>
+<h3 class="section">1 Invoking ntp-wait</h3>
+<a name="index-ntp_002dwait"></a>
+<a name="index-Wait-for-ntpd-to-stabilize-the-system-clock"></a>
-<h3 class="section">0.1 Invoking ntp-wait</h3>
-<p><a name="index-ntp_002dwait-1"></a><a name="index-Wait-for-ntpd-to-stabilize-the-system-clock-2"></a>
-
<p><code>ntp-wait</code>
+<p><code>ntp-wait</code>
will send at most
<kbd>num-tries</kbd>
queries to
after each status return that says
<code>ntpd(8)</code>
has not yet produced a synchronized and stable system clock.
-
-
<p><code>ntp-wait</code>
+</p>
+<p><code>ntp-wait</code>
will do this quietly, unless the
<code>-v</code>
-flag is provided.
+flag is provided.
This can be useful at boot time, to delay the boot sequence until after
<kbd>ntpd</kbd> <kbd>-g</kbd>
has set the time.
-
-
<p>This section was generated by <strong>AutoGen</strong>,
+</p>
+<p>This section was generated by <strong>AutoGen</strong>,
using the <code>agtexi-cmd</code> template and the option descriptions for the <code>ntp-wait</code> program.
-
-<ul class="menu">
-<li><a accesskey="1" href="#ntp_002dwait-usage">ntp-wait usage</a>: ntp-wait help/usage (<samp><span class="option">--help</span></samp>)
-<li><a accesskey="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)
-<li><a accesskey="5" href="#ntp_002dwait-exit-status">ntp-wait exit status</a>: exit status
-<li><a accesskey="6" href="#ntp_002dwait-Authors">ntp-wait Authors</a>: Authors
-<li><a accesskey="7" href="#ntp_002dwait-Notes">ntp-wait Notes</a>: Notes
-</ul>
-
-<div class="node">
-<a name="ntp-wait-usage"></a>
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• <a href="#ntp_002dwait-usage" accesskey="1">ntp-wait usage</a>:</td><td> </td><td align="left" valign="top">ntp-wait help/usage (<samp>--help</samp>)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntp_002dwait-tries" accesskey="2">ntp-wait tries</a>:</td><td> </td><td align="left" valign="top">tries option (-n)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntp_002dwait-sleep" accesskey="3">ntp-wait sleep</a>:</td><td> </td><td align="left" valign="top">sleep option (-s)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntp_002dwait-verbose" accesskey="4">ntp-wait verbose</a>:</td><td> </td><td align="left" valign="top">verbose option (-v)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntp_002dwait-exit-status" accesskey="5">ntp-wait exit status</a>:</td><td> </td><td align="left" valign="top">exit status
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntp_002dwait-Authors" accesskey="6">ntp-wait Authors</a>:</td><td> </td><td align="left" valign="top">Authors
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntp_002dwait-Notes" accesskey="7">ntp-wait Notes</a>:</td><td> </td><td align="left" valign="top">Notes
+</td></tr>
+</table>
+
+<hr>
<a name="ntp_002dwait-usage"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntp_002dwait-tries" accesskey="n" rel="next">ntp-wait tries</a>, Up: <a href="#ntp_002dwait-Invocation" accesskey="u" rel="up">ntp-wait Invocation</a> </p>
</div>
-
-<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
-(<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.
+<a name="ntp_002dwait-help_002fusage-_0028_002d_002dhelp_0029"></a>
+<h4 class="subsection">1.1 ntp-wait help/usage (<samp>--help</samp>)</h4>
+<a name="index-ntp_002dwait-help"></a>
+
+<p>This is the automatically generated usage text for ntp-wait.
+</p>
+<p>The text printed is the same whether selected with the <code>help</code> option
+(<samp>--help</samp>) or the <code>more-help</code> option (<samp>--more-help</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 <samp><span class="file">more</span></samp>. Both will exit
+used to select the program, defaulting to <samp>more</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.8p13
-USAGE: ntp-wait [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
+</p>
+<div class="example">
+<pre class="example">ntp-wait - Wait for ntpd to stabilize the system clock - Ver. 4.2.8p13-foo
+USAGE: ntp-wait [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
-n, --tries=num Number of times to check ntpd
-s, --sleep=num How long to sleep between tries
Options are specified by doubled hyphens and their name or by a single
hyphen and the flag character.
-</pre>
- <div class="node">
-<a name="ntp-wait-tries"></a>
-<a name="ntp_002dwait-tries"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dwait-sleep">ntp-wait sleep</a>,
-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>
+</pre></div>
+<hr>
+<a name="ntp_002dwait-tries"></a>
+<div class="header">
+<p>
+Next: <a href="#ntp_002dwait-sleep" accesskey="n" rel="next">ntp-wait sleep</a>, Previous: <a href="#ntp_002dwait-usage" accesskey="p" rel="prev">ntp-wait usage</a>, Up: <a href="#ntp_002dwait-Invocation" accesskey="u" rel="up">ntp-wait Invocation</a> </p>
</div>
+<a name="tries-option-_0028_002dn_0029"></a>
+<h4 class="subsection">1.2 tries option (-n)</h4>
+<a name="index-ntp_002dwait_002dtries"></a>
-<h4 class="subsection">0.1.2 tries option (-n)</h4>
-
-<p><a name="index-ntp_002dwait_002dtries-4"></a>
-This is the “number of times to check ntpd” option.
-This option takes a number argument.
+<p>This is the “number of times to check ntpd” option.
+This option takes a number argument.
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>
+ it has been able to synchronize and stabilize the system clock.
+</p><hr>
<a name="ntp_002dwait-sleep"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntp_002dwait-verbose" accesskey="n" rel="next">ntp-wait verbose</a>, Previous: <a href="#ntp_002dwait-tries" accesskey="p" rel="prev">ntp-wait tries</a>, Up: <a href="#ntp_002dwait-Invocation" accesskey="u" rel="up">ntp-wait Invocation</a> </p>
</div>
-
-<h4 class="subsection">0.1.3 sleep option (-s)</h4>
-
-<p><a name="index-ntp_002dwait_002dsleep-5"></a>
-This is the “how long to sleep between tries” option.
-This option takes a number argument <samp><span class="file">secs-between-tries</span></samp>.
- We will sleep for <samp><span class="file">secs-between-tries</span></samp> after each query
- of <code>ntpd</code> that returns "the time is not yet stable".
-<div class="node">
-<a name="ntp-wait-verbose"></a>
+<a name="sleep-option-_0028_002ds_0029"></a>
+<h4 class="subsection">1.3 sleep option (-s)</h4>
+<a name="index-ntp_002dwait_002dsleep"></a>
+
+<p>This is the “how long to sleep between tries” option.
+This option takes a number argument <samp>secs-between-tries</samp>.
+ We will sleep for <samp>secs-between-tries</samp> after each query
+ of <code>ntpd</code> that returns "the time is not yet stable".
+</p><hr>
<a name="ntp_002dwait-verbose"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntp_002dwait-exit-status" accesskey="n" rel="next">ntp-wait exit status</a>, Previous: <a href="#ntp_002dwait-sleep" accesskey="p" rel="prev">ntp-wait sleep</a>, Up: <a href="#ntp_002dwait-Invocation" accesskey="u" rel="up">ntp-wait Invocation</a> </p>
</div>
-
-<h4 class="subsection">0.1.4 verbose option (-v)</h4>
-
-<p><a name="index-ntp_002dwait_002dverbose-6"></a>
-This is the “be verbose” option.
- 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="verbose-option-_0028_002dv_0029"></a>
+<h4 class="subsection">1.4 verbose option (-v)</h4>
+<a name="index-ntp_002dwait_002dverbose"></a>
+
+<p>This is the “be verbose” option.
+ By default, <code>ntp-wait</code> is silent.
+ With this option, <code>ntp-wait</code> will provide status information.
+</p><hr>
<a name="ntp_002dwait-exit-status"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntp_002dwait-Authors" accesskey="n" rel="next">ntp-wait Authors</a>, Previous: <a href="#ntp_002dwait-verbose" accesskey="p" rel="prev">ntp-wait verbose</a>, Up: <a href="#ntp_002dwait-Invocation" accesskey="u" rel="up">ntp-wait Invocation</a> </p>
</div>
-
-<h4 class="subsection">0.1.5 ntp-wait exit status</h4>
+<a name="ntp_002dwait-exit-status-1"></a>
+<h4 class="subsection">1.5 ntp-wait exit status</h4>
<p>One of the following exit values will be returned:
- <dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
+</p><dl compact="compact">
+<dt>‘<samp>0 (EXIT_SUCCESS)</samp>’</dt>
+<dd><p>Successful program execution.
+</p></dd>
+<dt>‘<samp>1 (EXIT_FAILURE)</samp>’</dt>
+<dd><p>The operation failed or the command syntax was not valid.
+</p></dd>
</dl>
- <div class="node">
-<a name="ntp-wait-Authors"></a>
+<hr>
<a name="ntp_002dwait-Authors"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntp_002dwait-Notes" accesskey="n" rel="next">ntp-wait Notes</a>, Previous: <a href="#ntp_002dwait-exit-status" accesskey="p" rel="prev">ntp-wait exit status</a>, Up: <a href="#ntp_002dwait-Invocation" accesskey="u" rel="up">ntp-wait Invocation</a> </p>
</div>
-
-<h4 class="subsection">0.1.6 ntp-wait Authors</h4>
-
-<div class="node">
-<a name="ntp-wait-Notes"></a>
+<a name="ntp_002dwait-Authors-1"></a>
+<h4 class="subsection">1.6 ntp-wait Authors</h4>
+<hr>
<a name="ntp_002dwait-Notes"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Previous: <a href="#ntp_002dwait-Authors" accesskey="p" rel="prev">ntp-wait Authors</a>, Up: <a href="#ntp_002dwait-Invocation" accesskey="u" rel="up">ntp-wait Invocation</a> </p>
</div>
+<a name="ntp_002dwait-Notes-1"></a>
+<h4 class="subsection">1.7 ntp-wait Notes</h4>
+<hr>
-<h4 class="subsection">0.1.7 ntp-wait Notes</h4>
-</body></html>
+</body>
+</html>
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntp-wait @NTP_WAIT_MS@ "04 Feb 2020" "ntp (4.2.8p13)" "User Commands"
+.TH ntp-wait @NTP_WAIT_MS@ "03 Mar 2020" "ntp (4.2.8p13-foo)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:14 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:33:58 PM by AutoGen 5.18.5
.\" From the definitions ntp-wait-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt NTP_WAIT @NTP_WAIT_MS@ User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntp-wait-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:11 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:33:55 PM by AutoGen 5.18.5
.\" From the definitions ntp-wait-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-ntpsweep.texi)
#
-# It has been AutoGen-ed February 4, 2020 at 11:52:17 PM by AutoGen 5.18.5
+# It has been AutoGen-ed March 3, 2020 at 04:33:59 PM by AutoGen 5.18.5
# From the definitions ntpsweep-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@exampleindent 0
@example
-ntpsweep - Print various informations about given ntp servers - Ver. 4.2.8p13
+ntpsweep - Print various informations about given ntp servers - Ver. 4.2.8p13-foo
USAGE: ntpsweep [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... [hostfile]
-l, --host-list=str Host to execute actions on
# EDIT THIS FILE WITH CAUTION (ntpsweep-opts)
#
-# It has been AutoGen-ed February 4, 2020 at 11:52:15 PM by AutoGen 5.18.5
+# It has been AutoGen-ed March 3, 2020 at 04:33:59 PM by AutoGen 5.18.5
# From the definitions ntpsweep-opts.def
# and the template file perlopt
'help|?', 'more-help'));
$usage = <<'USAGE';
-ntpsweep - Print various informations about given ntp servers - Ver. 4.2.8p13
+ntpsweep - Print various informations about given ntp servers - Ver. 4.2.8p13-foo
USAGE: ntpsweep [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [hostfile]
-l, --host-list=str Host to execute actions on
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntpsweep 1ntpsweepman "04 Feb 2020" "ntp (4.2.8p13)" "User Commands"
+.TH ntpsweep 1ntpsweepman "03 Mar 2020" "ntp (4.2.8p13-foo)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:19 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:02 PM by AutoGen 5.18.5
.\" From the definitions ntpsweep-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt NTPSWEEP 1ntpsweepmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntpsweep-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:16 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:01 PM by AutoGen 5.18.5
.\" From the definitions ntpsweep-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
-<html lang="en">
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
-<title>ntpsweep User's Manual</title>
-<meta http-equiv="Content-Type" content="text/html">
-<meta name="description" content="ntpsweep User's Manual">
-<meta name="generator" content="makeinfo 4.13">
-<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">
-<style type="text/css"><!--
- pre.display { font-family:inherit }
- pre.format { font-family:inherit }
- pre.smalldisplay { font-family:inherit; font-size:smaller }
- pre.smallformat { font-family:inherit; font-size:smaller }
- pre.smallexample { font-size:smaller }
- pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family:serif; font-weight:normal; }
- span.sansserif { font-family:sans-serif; font-weight:normal; }
---></style>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<title>ntpsweep User’s Manual</title>
+
+<meta name="description" content="ntpsweep User’s Manual">
+<meta name="keywords" content="ntpsweep User’s Manual">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<link href="#Top" rel="start" title="Top">
+<link href="dir.html#Top" rel="up" title="(dir)">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+blockquote.indentedblock {margin-right: 0em}
+blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
+blockquote.smallquotation {font-size: smaller}
+div.display {margin-left: 3.2em}
+div.example {margin-left: 3.2em}
+div.lisp {margin-left: 3.2em}
+div.smalldisplay {margin-left: 3.2em}
+div.smallexample {margin-left: 3.2em}
+div.smalllisp {margin-left: 3.2em}
+kbd {font-style: oblique}
+pre.display {font-family: inherit}
+pre.format {font-family: inherit}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: inherit; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: inherit; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.nolinebreak {white-space: nowrap}
+span.roman {font-family: initial; font-weight: normal}
+span.sansserif {font-family: sans-serif; font-weight: normal}
+ul.no-bullet {list-style: none}
+-->
+</style>
+
+
</head>
-<body>
-<h1 class="settitle">ntpsweep User's Manual</h1>
-<div class="node">
-<a name="Top"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpsweep-Description">ntpsweep Description</a>,
-Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>,
-Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
-</div>
+<body lang="en">
+<h1 class="settitle" align="center">ntpsweep User’s Manual</h1>
- <p>This document describes the use of the NTP Project's <code>ntpsweep</code> program.
- <p>This document applies to version 4.2.8p13 of <code>ntpsweep</code>.
- <div class="shortcontents">
-<h2>Short Contents</h2>
-<ul>
-</ul>
-</div>
-<ul class="menu">
-<li><a accesskey="1" href="#ntpsweep-Description">ntpsweep Description</a>: Description
-<li><a accesskey="2" href="#ntpsweep-Invocation">ntpsweep Invocation</a>: Invoking ntpsweep
-</ul>
-<div class="node">
-<a name="ntpsweep-Invocation"></a>
-<p><hr>
+<a name="Top"></a>
+<div class="header">
+<p>
+Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> </p>
+</div>
+<h1 class="node-heading">Top</h1>
+<p>This document describes the use of the NTP Project’s <code>ntpsweep</code> program.
+</p>
+<p>This document applies to version 4.2.8p13-foo of <code>ntpsweep</code>.
+</p>
+<a name="SEC_Overview"></a>
+<h2 class="shortcontents-heading">Short Table of Contents</h2>
+
+<div class="shortcontents">
+<li><a name="stoc-Invoking-ntpsweep" href="#toc-Invoking-ntpsweep">1 Invoking ntpsweep</a></li>
</div>
-<h3 class="section">0.1 Invoking ntpsweep</h3>
-<p><a name="index-ntpsweep-1"></a><a name="index-Print-various-informations-about-given-ntp-servers-2"></a>
-<code>ntpsweep</code>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• ntpsweep Description:</td><td> </td><td align="left" valign="top">Description
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpsweep-Invocation" accesskey="2">ntpsweep Invocation</a>:</td><td> </td><td align="left" valign="top">Invoking ntpsweep
+</td></tr>
+</table>
+
+<hr>
+<a name="ntpsweep-Invocation"></a>
+<div class="header">
+<p>
+Up: <a href="#Top" accesskey="u" rel="up">Top</a> </p>
+</div>
+<a name="Invoking-ntpsweep"></a>
+<h3 class="section">1 Invoking ntpsweep</h3>
+<a name="index-ntpsweep"></a>
+<a name="index-Print-various-informations-about-given-ntp-servers"></a>
+
+<p><code>ntpsweep</code>
prints per host the NTP stratum level, the clock offset in seconds, the daemon
version, the operating system and the processor. Optionally recursing through
all peers.
-
-
<p>This section was generated by <strong>AutoGen</strong>,
+</p>
+<p>This section was generated by <strong>AutoGen</strong>,
using the <code>agtexi-cmd</code> template and the option descriptions for the <code>ntpsweep</code> program.
-
-<ul class="menu">
-<li><a accesskey="1" href="#ntpsweep-usage">ntpsweep usage</a>: ntpsweep help/usage (<samp><span class="option">--help</span></samp>)
-<li><a accesskey="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)
-<li><a accesskey="5" href="#ntpsweep-strip">ntpsweep strip</a>: strip option (-s)
-<li><a accesskey="6" href="#ntpsweep-host">ntpsweep host</a>: host option (-h)
-<li><a accesskey="7" href="#ntpsweep-exit-status">ntpsweep exit status</a>: exit status
-</ul>
-
-<div class="node">
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• <a href="#ntpsweep-usage" accesskey="1">ntpsweep usage</a>:</td><td> </td><td align="left" valign="top">ntpsweep help/usage (<samp>--help</samp>)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpsweep-host_002dlist" accesskey="2">ntpsweep host-list</a>:</td><td> </td><td align="left" valign="top">host-list option (-l)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpsweep-peers" accesskey="3">ntpsweep peers</a>:</td><td> </td><td align="left" valign="top">peers option (-p)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpsweep-maxlevel" accesskey="4">ntpsweep maxlevel</a>:</td><td> </td><td align="left" valign="top">maxlevel option (-m)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpsweep-strip" accesskey="5">ntpsweep strip</a>:</td><td> </td><td align="left" valign="top">strip option (-s)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpsweep-host" accesskey="6">ntpsweep host</a>:</td><td> </td><td align="left" valign="top">host option (-h)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntpsweep-exit-status" accesskey="7">ntpsweep exit status</a>:</td><td> </td><td align="left" valign="top">exit status
+</td></tr>
+</table>
+
+<hr>
<a name="ntpsweep-usage"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntpsweep-host_002dlist" accesskey="n" rel="next">ntpsweep host-list</a>, Up: <a href="#ntpsweep-Invocation" accesskey="u" rel="up">ntpsweep Invocation</a> </p>
</div>
-
-<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
-(<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.
+<a name="ntpsweep-help_002fusage-_0028_002d_002dhelp_0029"></a>
+<h4 class="subsection">1.1 ntpsweep help/usage (<samp>--help</samp>)</h4>
+<a name="index-ntpsweep-help"></a>
+
+<p>This is the automatically generated usage text for ntpsweep.
+</p>
+<p>The text printed is the same whether selected with the <code>help</code> option
+(<samp>--help</samp>) or the <code>more-help</code> option (<samp>--more-help</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 <samp><span class="file">more</span></samp>. Both will exit
+used to select the program, defaulting to <samp>more</samp>. Both will exit
with a status code of 0.
-
-<pre class="example">ntpsweep - Print various informations about given ntp servers - Ver. 4.2.8p13
+</p>
+<div class="example">
+<pre class="example">ntpsweep - Print various informations about given ntp servers - Ver. 4.2.8p13-foo
USAGE: ntpsweep [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [hostfile]
-l, --host-list=str Host to execute actions on
Options are specified by doubled hyphens and their name or by a single
hyphen and the flag character.
-</pre>
- <div class="node">
-<a name="ntpsweep-host-list"></a>
-<a name="ntpsweep-host_002dlist"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpsweep-peers">ntpsweep peers</a>,
-Previous: <a rel="previous" accesskey="p" href="#ntpsweep-usage">ntpsweep usage</a>,
-Up: <a rel="up" accesskey="u" href="#ntpsweep-Invocation">ntpsweep Invocation</a>
+</pre></div>
+<hr>
+<a name="ntpsweep-host_002dlist"></a>
+<div class="header">
+<p>
+Next: <a href="#ntpsweep-peers" accesskey="n" rel="next">ntpsweep peers</a>, Previous: <a href="#ntpsweep-usage" accesskey="p" rel="prev">ntpsweep usage</a>, Up: <a href="#ntpsweep-Invocation" accesskey="u" rel="up">ntpsweep Invocation</a> </p>
</div>
+<a name="host_002dlist-option-_0028_002dl_0029"></a>
+<h4 class="subsection">1.2 host-list option (-l)</h4>
+<a name="index-ntpsweep_002dhost_002dlist"></a>
-<h4 class="subsection">0.1.2 host-list option (-l)</h4>
-
-<p><a name="index-ntpsweep_002dhost_002dlist-4"></a>
-This is the “host to execute actions on” option.
+<p>This is the “host to execute actions on” option.
This option takes a string argument.
-
-<p class="noindent">This option has some usage constraints. It:
-<li>may appear an unlimited number of times.
-</ul>
-
- <p>Use this option to specify the host on which this script operates.
- May appear multiple times.
-<div class="node">
+</p>
+<p>This option has some usage constraints. It:
+<li> may appear an unlimited number of times.
+</li></ul>
+
+<p>Use this option to specify the host on which this script operates.
+ May appear multiple times.
+</p><hr>
<a name="ntpsweep-peers"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntpsweep-maxlevel" accesskey="n" rel="next">ntpsweep maxlevel</a>, Previous: <a href="#ntpsweep-host_002dlist" accesskey="p" rel="prev">ntpsweep host-list</a>, Up: <a href="#ntpsweep-Invocation" accesskey="u" rel="up">ntpsweep Invocation</a> </p>
</div>
+<a name="peers-option-_0028_002dp_0029"></a>
+<h4 class="subsection">1.3 peers option (-p)</h4>
+<a name="index-ntpsweep_002dpeers"></a>
-<h4 class="subsection">0.1.3 peers option (-p)</h4>
-
-<p><a name="index-ntpsweep_002dpeers-5"></a>
-This is the “recursively list all peers a host synchronizes to” option.
-This option has no ‘<samp><span class="samp">doc</span></samp>’ documentation.
-<div class="node">
+<p>This is the “recursively list all peers a host synchronizes to” option.
+This option has no ‘<samp>doc</samp>’ documentation.
+</p><hr>
<a name="ntpsweep-maxlevel"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntpsweep-strip" accesskey="n" rel="next">ntpsweep strip</a>, Previous: <a href="#ntpsweep-peers" accesskey="p" rel="prev">ntpsweep peers</a>, Up: <a href="#ntpsweep-Invocation" accesskey="u" rel="up">ntpsweep Invocation</a> </p>
</div>
-
-<h4 class="subsection">0.1.4 maxlevel option (-m)</h4>
-
-<p><a name="index-ntpsweep_002dmaxlevel-6"></a>
-This is the “traverse peers up to this level (4 is a reasonable number)” option.
-This option takes a number argument.
-This option has no ‘<samp><span class="samp">doc</span></samp>’ documentation.
-<div class="node">
+<a name="maxlevel-option-_0028_002dm_0029"></a>
+<h4 class="subsection">1.4 maxlevel option (-m)</h4>
+<a name="index-ntpsweep_002dmaxlevel"></a>
+
+<p>This is the “traverse peers up to this level (4 is a reasonable number)” option.
+This option takes a number argument.
+This option has no ‘<samp>doc</samp>’ documentation.
+</p><hr>
<a name="ntpsweep-strip"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntpsweep-host" accesskey="n" rel="next">ntpsweep host</a>, Previous: <a href="#ntpsweep-maxlevel" accesskey="p" rel="prev">ntpsweep maxlevel</a>, Up: <a href="#ntpsweep-Invocation" accesskey="u" rel="up">ntpsweep Invocation</a> </p>
</div>
+<a name="strip-option-_0028_002ds_0029"></a>
+<h4 class="subsection">1.5 strip option (-s)</h4>
+<a name="index-ntpsweep_002dstrip"></a>
-<h4 class="subsection">0.1.5 strip option (-s)</h4>
-
-<p><a name="index-ntpsweep_002dstrip-7"></a>
-This is the “strip this string from hostnames” option.
-This option takes a string argument.
-This option has no ‘<samp><span class="samp">doc</span></samp>’ documentation.
-<div class="node">
+<p>This is the “strip this string from hostnames” option.
+This option takes a string argument.
+This option has no ‘<samp>doc</samp>’ documentation.
+</p><hr>
<a name="ntpsweep-host"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntpsweep-exit-status" accesskey="n" rel="next">ntpsweep exit status</a>, Previous: <a href="#ntpsweep-strip" accesskey="p" rel="prev">ntpsweep strip</a>, Up: <a href="#ntpsweep-Invocation" accesskey="u" rel="up">ntpsweep Invocation</a> </p>
</div>
+<a name="host-option-_0028_002dh_0029"></a>
+<h4 class="subsection">1.6 host option (-h)</h4>
+<a name="index-ntpsweep_002dhost"></a>
-<h4 class="subsection">0.1.6 host option (-h)</h4>
-
-<p><a name="index-ntpsweep_002dhost-8"></a>
-This is the “specify a single host” option.
-This option takes a string argument.
-This option has no ‘<samp><span class="samp">doc</span></samp>’ documentation.
-
- <p><strong>NOTE</strong><strong>: THIS OPTION IS DEPRECATED</strong>
-<div class="node">
+<p>This is the “specify a single host” option.
+This option takes a string argument.
+This option has no ‘<samp>doc</samp>’ documentation.
+</p>
+<p><strong>NOTE</strong><strong>: THIS OPTION IS DEPRECATED</strong>
+</p><hr>
<a name="ntpsweep-exit-status"></a>
-<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#ntpsweep-host">ntpsweep host</a>,
-Up: <a rel="up" accesskey="u" href="#ntpsweep-Invocation">ntpsweep Invocation</a>
-
+<div class="header">
+<p>
+Previous: <a href="#ntpsweep-host" accesskey="p" rel="prev">ntpsweep host</a>, Up: <a href="#ntpsweep-Invocation" accesskey="u" rel="up">ntpsweep Invocation</a> </p>
</div>
-
-<h4 class="subsection">0.1.7 ntpsweep exit status</h4>
+<a name="ntpsweep-exit-status-1"></a>
+<h4 class="subsection">1.7 ntpsweep exit status</h4>
<p>One of the following exit values will be returned:
- <dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
+</p><dl compact="compact">
+<dt>‘<samp>0 (EXIT_SUCCESS)</samp>’</dt>
+<dd><p>Successful program execution.
+</p></dd>
+<dt>‘<samp>1 (EXIT_FAILURE)</samp>’</dt>
+<dd><p>The operation failed or the command syntax was not valid.
+</p></dd>
</dl>
+<hr>
+
-</body></html>
+</body>
+</html>
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntpsweep 1ntpsweepman "04 Feb 2020" "ntp (4.2.8p13)" "User Commands"
+.TH ntpsweep 1ntpsweepman "03 Mar 2020" "ntp (4.2.8p13-foo)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:19 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:02 PM by AutoGen 5.18.5
.\" From the definitions ntpsweep-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt NTPSWEEP 1ntpsweepmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntpsweep-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:16 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:01 PM by AutoGen 5.18.5
.\" From the definitions ntpsweep-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-ntptrace.texi)
#
-# It has been AutoGen-ed February 4, 2020 at 11:52:22 PM by AutoGen 5.18.5
+# It has been AutoGen-ed March 3, 2020 at 04:34:04 PM by AutoGen 5.18.5
# From the definitions ntptrace-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@exampleindent 0
@example
-ntptrace - Trace peers of an NTP server - Ver. 4.2.8p13
+ntptrace - Trace peers of an NTP server - Ver. 4.2.8p13-foo
USAGE: ntptrace [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... [host]
-n, --numeric Print IP addresses instead of hostnames
# EDIT THIS FILE WITH CAUTION (ntptrace-opts)
#
-# It has been AutoGen-ed February 4, 2020 at 11:52:20 PM by AutoGen 5.18.5
+# It has been AutoGen-ed March 3, 2020 at 04:34:03 PM by AutoGen 5.18.5
# From the definitions ntptrace-opts.def
# and the template file perlopt
'help|?', 'more-help'));
$usage = <<'USAGE';
-ntptrace - Trace peers of an NTP server - Ver. 4.2.8p13
+ntptrace - Trace peers of an NTP server - Ver. 4.2.8p13-foo
USAGE: ntptrace [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [host]
-n, --numeric Print IP addresses instead of hostnames
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntptrace 1ntptraceman "04 Feb 2020" "ntp (4.2.8p13)" "User Commands"
+.TH ntptrace 1ntptraceman "03 Mar 2020" "ntp (4.2.8p13-foo)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:23 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:06 PM by AutoGen 5.18.5
.\" From the definitions ntptrace-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt NTPTRACE 1ntptracemdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntptrace-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:20 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:03 PM by AutoGen 5.18.5
.\" From the definitions ntptrace-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
-<html lang="en">
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
-<title>Ntptrace User's Manual</title>
-<meta http-equiv="Content-Type" content="text/html">
-<meta name="description" content="Ntptrace User's Manual">
-<meta name="generator" content="makeinfo 4.13">
-<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">
-<style type="text/css"><!--
- pre.display { font-family:inherit }
- pre.format { font-family:inherit }
- pre.smalldisplay { font-family:inherit; font-size:smaller }
- pre.smallformat { font-family:inherit; font-size:smaller }
- pre.smallexample { font-size:smaller }
- pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family:serif; font-weight:normal; }
- span.sansserif { font-family:sans-serif; font-weight:normal; }
---></style>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<title>Ntptrace User’s Manual</title>
+
+<meta name="description" content="Ntptrace User’s Manual">
+<meta name="keywords" content="Ntptrace User’s Manual">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<link href="#Top" rel="start" title="Top">
+<link href="dir.html#Top" rel="up" title="(dir)">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+blockquote.indentedblock {margin-right: 0em}
+blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
+blockquote.smallquotation {font-size: smaller}
+div.display {margin-left: 3.2em}
+div.example {margin-left: 3.2em}
+div.lisp {margin-left: 3.2em}
+div.smalldisplay {margin-left: 3.2em}
+div.smallexample {margin-left: 3.2em}
+div.smalllisp {margin-left: 3.2em}
+kbd {font-style: oblique}
+pre.display {font-family: inherit}
+pre.format {font-family: inherit}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: inherit; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: inherit; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.nolinebreak {white-space: nowrap}
+span.roman {font-family: initial; font-weight: normal}
+span.sansserif {font-family: sans-serif; font-weight: normal}
+ul.no-bullet {list-style: none}
+-->
+</style>
+
+
</head>
-<body>
-<h1 class="settitle">Ntptrace User's Manual</h1>
-<div class="node">
-<a name="Top"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntptrace-Description">ntptrace Description</a>,
-Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>,
-Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
-</div>
+<body lang="en">
+<h1 class="settitle" align="center">Ntptrace User’s Manual</h1>
+
-<h2 class="unnumbered">Simple Network Time Protocol User Manual</h2>
-<p>This document describes the use of the NTP Project's <code>ntptrace</code> program.
-This document applies to version 4.2.8p13 of <code>ntptrace</code>.
- <div class="shortcontents">
-<h2>Short Contents</h2>
-<ul>
-<a href="#Top">Simple Network Time Protocol User Manual</a>
+
+<a name="Top"></a>
+<div class="header">
+<p>
+Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> </p>
+</div>
+<a name="Simple-Network-Time-Protocol-User-Manual"></a>
+<h1 class="top">Simple Network Time Protocol User Manual</h1>
+
+<p>This document describes the use of the NTP Project’s <code>ntptrace</code> program.
+This document applies to version 4.2.8p13-foo of <code>ntptrace</code>.
+</p>
+<a name="SEC_Overview"></a>
+<h2 class="shortcontents-heading">Short Table of Contents</h2>
+
+<div class="shortcontents">
+<ul class="no-bullet">
+<li><a name="stoc-Invoking-ntptrace" href="#toc-Invoking-ntptrace">1 Invoking ntptrace</a></li>
</ul>
</div>
-<ul class="menu">
-<li><a accesskey="1" href="#ntptrace-Description">ntptrace Description</a>: Description
-<li><a accesskey="2" href="#ntptrace-Invocation">ntptrace Invocation</a>: Invoking ntptrace
-</ul>
-<div class="node">
-<a name="ntptrace-Invocation"></a>
-<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#ntptrace-Description">ntptrace Description</a>,
-Up: <a rel="up" accesskey="u" href="#Top">Top</a>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• ntptrace Description:</td><td> </td><td align="left" valign="top">Description
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntptrace-Invocation" accesskey="2">ntptrace Invocation</a>:</td><td> </td><td align="left" valign="top">Invoking ntptrace
+</td></tr>
+</table>
+<hr>
+<a name="ntptrace-Invocation"></a>
+<div class="header">
+<p>
+Up: <a href="#Top" accesskey="u" rel="up">Top</a> </p>
</div>
+<a name="Invoking-ntptrace"></a>
+<h2 class="chapter">1 Invoking ntptrace</h2>
+<a name="index-ntptrace"></a>
+<a name="index-Trace-peers-of-an-NTP-server"></a>
-<h3 class="section">Invoking ntptrace</h3>
-
-<p><a name="index-ntptrace-1"></a><a name="index-Trace-peers-of-an-NTP-server-2"></a>
-<code>ntptrace</code> is a perl script that uses the ntpq utility program to follow
+<p><code>ntptrace</code> is a perl script that uses the ntpq utility program to follow
the chain of NTP servers from a given host back to the primary time source. For
ntptrace to work properly, each of these servers must implement the NTP Control
and Monitoring Protocol specified in RFC 1305 and enable NTP Mode 6 packets.
-
-
<p>If given no arguments, ntptrace starts with localhost. Here is an example of
+</p>
+<p>If given no arguments, ntptrace starts with localhost. Here is an example of
the output from ntptrace:
-
-<pre class="example"> % ntptrace localhost: stratum 4, offset 0.0019529, synch distance 0.144135
- server2ozo.com: stratum 2, offset 0.0124263, synch distance 0.115784 usndh.edu:
- stratum 1, offset 0.0019298, synch distance 0.011993, refid 'WWVB'
-</pre>
- <p>On each line, the fields are (left to right): the host name, the host stratum,
+</p>
+<div class="example">
+<pre class="example">% ntptrace localhost: stratum 4, offset 0.0019529, synch distance 0.144135
+server2ozo.com: stratum 2, offset 0.0124263, synch distance 0.115784 usndh.edu:
+stratum 1, offset 0.0019298, synch distance 0.011993, refid 'WWVB'
+</pre></div>
+
+<p>On each line, the fields are (left to right): the host name, the host stratum,
the time offset between that host and the local host (as measured by
-<code>ntptrace</code>; this is why it is not always zero for "localhost"), the host
+<code>ntptrace</code>; this is why it is not always zero for "localhost"), the host
synchronization distance, and (only for stratum-1 servers) the reference clock
ID. All times are given in seconds. Note that the stratum is the server hop
count to the primary source, while the synchronization distance is the
estimated error relative to the primary source. These terms are precisely
defined in RFC-1305.
+</p>
-
<p>This section was generated by <strong>AutoGen</strong>,
+<p>This section was generated by <strong>AutoGen</strong>,
using the <code>agtexi-cmd</code> template and the option descriptions for the <code>ntptrace</code> program.
-
-<ul class="menu">
-<li><a accesskey="1" href="#ntptrace-usage">ntptrace usage</a>: ntptrace help/usage (<samp><span class="option">--help</span></samp>)
-<li><a accesskey="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)
-<li><a accesskey="5" href="#ntptrace-exit-status">ntptrace exit status</a>: exit status
-</ul>
-
-<div class="node">
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• <a href="#ntptrace-usage" accesskey="1">ntptrace usage</a>:</td><td> </td><td align="left" valign="top">ntptrace help/usage (<samp>--help</samp>)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntptrace-numeric" accesskey="2">ntptrace numeric</a>:</td><td> </td><td align="left" valign="top">numeric option (-n)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntptrace-max_002dhosts" accesskey="3">ntptrace max-hosts</a>:</td><td> </td><td align="left" valign="top">max-hosts option (-m)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntptrace-host" accesskey="4">ntptrace host</a>:</td><td> </td><td align="left" valign="top">host option (-r)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntptrace-exit-status" accesskey="5">ntptrace exit status</a>:</td><td> </td><td align="left" valign="top">exit status
+</td></tr>
+</table>
+
+<hr>
<a name="ntptrace-usage"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntptrace-numeric">ntptrace numeric</a>,
-Up: <a rel="up" accesskey="u" href="#ntptrace-Invocation">ntptrace Invocation</a>
-
+<div class="header">
+<p>
+Next: <a href="#ntptrace-numeric" accesskey="n" rel="next">ntptrace numeric</a>, Up: <a href="#ntptrace-Invocation" accesskey="u" rel="up">ntptrace Invocation</a> </p>
</div>
-
-<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
-(<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.
+<a name="ntptrace-help_002fusage-_0028_002d_002dhelp_0029"></a>
+<h3 class="section">1.1 ntptrace help/usage (<samp>--help</samp>)</h3>
+<a name="index-ntptrace-help"></a>
+
+<p>This is the automatically generated usage text for ntptrace.
+</p>
+<p>The text printed is the same whether selected with the <code>help</code> option
+(<samp>--help</samp>) or the <code>more-help</code> option (<samp>--more-help</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 <samp><span class="file">more</span></samp>. Both will exit
+used to select the program, defaulting to <samp>more</samp>. Both will exit
with a status code of 0.
-
-<pre class="example">ntptrace - Trace peers of an NTP server - Ver. 4.2.8p13
+</p>
+<div class="example">
+<pre class="example">ntptrace - Trace peers of an NTP server - Ver. 4.2.8p13-foo
USAGE: ntptrace [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [host]
-n, --numeric Print IP addresses instead of hostnames
Options are specified by doubled hyphens and their name or by a single
hyphen and the flag character.
-</pre>
- <div class="node">
+</pre></div>
+
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• <a href="#ntptrace-numeric" accesskey="1">ntptrace numeric</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntptrace-max_002dhosts" accesskey="2">ntptrace max-hosts</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntptrace-host" accesskey="3">ntptrace host</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#ntptrace-exit-status" accesskey="4">ntptrace exit status</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+</table>
+
+<hr>
<a name="ntptrace-numeric"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntptrace-max_002dhosts" accesskey="n" rel="next">ntptrace max-hosts</a>, Previous: <a href="#ntptrace-usage" accesskey="p" rel="prev">ntptrace usage</a>, Up: <a href="#ntptrace-usage" accesskey="u" rel="up">ntptrace usage</a> </p>
</div>
+<a name="numeric-option-_0028_002dn_0029"></a>
+<h4 class="subsection">1.1.1 numeric option (-n)</h4>
+<a name="index-ntptrace_002dnumeric"></a>
-<h4 class="subsection">numeric option (-n)</h4>
-
-<p><a name="index-ntptrace_002dnumeric-4"></a>
-This is the “print ip addresses instead of hostnames” option.
+<p>This is the “print ip addresses instead of hostnames” option.
Output hosts as dotted-quad numeric format rather than converting to
-the canonical host names.
-<div class="node">
-<a name="ntptrace-max-hosts"></a>
+the canonical host names.
+</p><hr>
<a name="ntptrace-max_002dhosts"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntptrace-host" accesskey="n" rel="next">ntptrace host</a>, Previous: <a href="#ntptrace-numeric" accesskey="p" rel="prev">ntptrace numeric</a>, Up: <a href="#ntptrace-usage" accesskey="u" rel="up">ntptrace usage</a> </p>
</div>
-
-<h4 class="subsection">max-hosts option (-m)</h4>
-
-<p><a name="index-ntptrace_002dmax_002dhosts-5"></a>
-This is the “maximum number of peers to trace” option.
-This option takes a number argument.
-This option has no ‘<samp><span class="samp">doc</span></samp>’ documentation.
-<div class="node">
+<a name="max_002dhosts-option-_0028_002dm_0029"></a>
+<h4 class="subsection">1.1.2 max-hosts option (-m)</h4>
+<a name="index-ntptrace_002dmax_002dhosts"></a>
+
+<p>This is the “maximum number of peers to trace” option.
+This option takes a number argument.
+This option has no ‘<samp>doc</samp>’ documentation.
+</p><hr>
<a name="ntptrace-host"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#ntptrace-exit-status" accesskey="n" rel="next">ntptrace exit status</a>, Previous: <a href="#ntptrace-max_002dhosts" accesskey="p" rel="prev">ntptrace max-hosts</a>, Up: <a href="#ntptrace-usage" accesskey="u" rel="up">ntptrace usage</a> </p>
</div>
-
-<h4 class="subsection">host option (-r)</h4>
-
-<p><a name="index-ntptrace_002dhost-6"></a>
-This is the “single remote host” option.
-This option takes a string argument.
-This option has no ‘<samp><span class="samp">doc</span></samp>’ documentation.
-<div class="node">
+<a name="host-option-_0028_002dr_0029"></a>
+<h4 class="subsection">1.1.3 host option (-r)</h4>
+<a name="index-ntptrace_002dhost"></a>
+
+<p>This is the “single remote host” option.
+This option takes a string argument.
+This option has no ‘<samp>doc</samp>’ documentation.
+</p><hr>
<a name="ntptrace-exit-status"></a>
-<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#ntptrace-host">ntptrace host</a>,
-Up: <a rel="up" accesskey="u" href="#ntptrace-Invocation">ntptrace Invocation</a>
-
+<div class="header">
+<p>
+Previous: <a href="#ntptrace-host" accesskey="p" rel="prev">ntptrace host</a>, Up: <a href="#ntptrace-usage" accesskey="u" rel="up">ntptrace usage</a> </p>
</div>
-
-<h4 class="subsection">ntptrace exit status</h4>
+<a name="ntptrace-exit-status-1"></a>
+<h4 class="subsection">1.1.4 ntptrace exit status</h4>
<p>One of the following exit values will be returned:
- <dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
+</p><dl compact="compact">
+<dt>‘<samp>0 (EXIT_SUCCESS)</samp>’</dt>
+<dd><p>Successful program execution.
+</p></dd>
+<dt>‘<samp>1 (EXIT_FAILURE)</samp>’</dt>
+<dd><p>The operation failed or the command syntax was not valid.
+</p></dd>
</dl>
+<hr>
+
-</body></html>
+</body>
+</html>
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntptrace @NTPTRACE_MS@ "04 Feb 2020" "ntp (4.2.8p13)" "User Commands"
+.TH ntptrace @NTPTRACE_MS@ "03 Mar 2020" "ntp (4.2.8p13-foo)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:23 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:06 PM by AutoGen 5.18.5
.\" From the definitions ntptrace-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt NTPTRACE @NTPTRACE_MS@ User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntptrace-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:20 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:03 PM by AutoGen 5.18.5
.\" From the definitions ntptrace-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
# EDIT THIS FILE WITH CAUTION (plot_summary-opts)
#
-# It has been AutoGen-ed February 4, 2020 at 11:52:29 PM by AutoGen 5.18.5
+# It has been AutoGen-ed March 3, 2020 at 04:34:11 PM by AutoGen 5.18.5
# From the definitions plot_summary-opts.def
# and the template file perlopt
'help|?', 'more-help'));
$usage = <<'USAGE';
-plot_summary - plot statistics generated by summary script - Ver. 4.2.8p13
+plot_summary - plot statistics generated by summary script - Ver. 4.2.8p13-foo
USAGE: plot_summary [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
--directory=str Where the summary files are
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH plot_summary 1plot_summaryman "04 Feb 2020" "ntp (4.2.8p13)" "User Commands"
+.TH plot_summary 1plot_summaryman "03 Mar 2020" "ntp (4.2.8p13-foo)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:31 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:12 PM by AutoGen 5.18.5
.\" From the definitions plot_summary-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt PLOT_SUMMARY 1plot_summarymdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (plot_summary-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:32 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:13 PM by AutoGen 5.18.5
.\" From the definitions plot_summary-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
-<html lang="en">
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
-<title>Plot_summary User's Manual</title>
-<meta http-equiv="Content-Type" content="text/html">
-<meta name="description" content="Plot_summary User's Manual">
-<meta name="generator" content="makeinfo 4.13">
-<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">
-<style type="text/css"><!--
- pre.display { font-family:inherit }
- pre.format { font-family:inherit }
- pre.smalldisplay { font-family:inherit; font-size:smaller }
- pre.smallformat { font-family:inherit; font-size:smaller }
- pre.smallexample { font-size:smaller }
- pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family:serif; font-weight:normal; }
- span.sansserif { font-family:sans-serif; font-weight:normal; }
---></style>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<title>Plot_summary User’s Manual</title>
+
+<meta name="description" content="Plot_summary User’s Manual">
+<meta name="keywords" content="Plot_summary User’s Manual">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<link href="#Top" rel="start" title="Top">
+<link href="dir.html#Top" rel="up" title="(dir)">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+blockquote.indentedblock {margin-right: 0em}
+blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
+blockquote.smallquotation {font-size: smaller}
+div.display {margin-left: 3.2em}
+div.example {margin-left: 3.2em}
+div.lisp {margin-left: 3.2em}
+div.smalldisplay {margin-left: 3.2em}
+div.smallexample {margin-left: 3.2em}
+div.smalllisp {margin-left: 3.2em}
+kbd {font-style: oblique}
+pre.display {font-family: inherit}
+pre.format {font-family: inherit}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: inherit; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: inherit; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.nolinebreak {white-space: nowrap}
+span.roman {font-family: initial; font-weight: normal}
+span.sansserif {font-family: sans-serif; font-weight: normal}
+ul.no-bullet {list-style: none}
+-->
+</style>
+
+
</head>
-<body>
-<h1 class="settitle">Plot_summary User's Manual</h1>
-<div class="node">
-<a name="Top"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#plot_005fsummary-Description">plot_summary Description</a>,
-Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>,
-Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
-</div>
+<body lang="en">
+<h1 class="settitle" align="center">Plot_summary User’s Manual</h1>
+
-<h2 class="unnumbered">Plot_summary User Manual</h2>
-<p>This document describes the use of the NTP Project's <code>plot_summary</code> program.
-This document applies to version 4.2.8p13 of <code>plot_summary</code>.
- <div class="shortcontents">
-<h2>Short Contents</h2>
-<ul>
-<a href="#Top">Plot_summary User Manual</a>
+
+<a name="Top"></a>
+<div class="header">
+<p>
+Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> </p>
+</div>
+<a name="Plot_005fsummary-User-Manual"></a>
+<h1 class="top">Plot_summary User Manual</h1>
+
+<p>This document describes the use of the NTP Project’s <code>plot_summary</code> program.
+This document applies to version 4.2.8p13-foo of <code>plot_summary</code>.
+</p>
+<a name="SEC_Overview"></a>
+<h2 class="shortcontents-heading">Short Table of Contents</h2>
+
+<div class="shortcontents">
+<ul class="no-bullet">
+<li><a name="stoc-Invoking-plot_005fsummary" href="#toc-Invoking-plot_005fsummary">1 Invoking plot_summary</a></li>
</ul>
</div>
-<ul class="menu">
-<li><a accesskey="1" href="#plot_005fsummary-Description">plot_summary Description</a>: Description
-<li><a accesskey="2" href="#plot_005fsummary-Invocation">plot_summary Invocation</a>: Invoking plot_summary
-</ul>
-<div class="node">
-<a name="plot_summary-Invocation"></a>
-<a name="plot_005fsummary-Invocation"></a>
-<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#plot_005fsummary-Description">plot_summary Description</a>,
-Up: <a rel="up" accesskey="u" href="#Top">Top</a>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• plot_summary Description:</td><td> </td><td align="left" valign="top">Description
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#plot_005fsummary-Invocation" accesskey="2">plot_summary Invocation</a>:</td><td> </td><td align="left" valign="top">Invoking plot_summary
+</td></tr>
+</table>
+<hr>
+<a name="plot_005fsummary-Invocation"></a>
+<div class="header">
+<p>
+Up: <a href="#Top" accesskey="u" rel="up">Top</a> </p>
</div>
+<a name="Invoking-plot_005fsummary"></a>
+<h2 class="chapter">1 Invoking plot_summary</h2>
+<a name="index-plot_005fsummary"></a>
+<a name="index-plot-statistics-generated-by-summary-script"></a>
-<h3 class="section">Invoking plot_summary</h3>
-
-<p><a name="index-plot_005fsummary-1"></a><a name="index-plot-statistics-generated-by-summary-script-2"></a>
-
<p>This section was generated by <strong>AutoGen</strong>,
+<p>This section was generated by <strong>AutoGen</strong>,
using the <code>agtexi-cmd</code> template and the option descriptions for the <code>plot_summary</code> program.
-
-<ul class="menu">
-<li><a accesskey="1" href="#plot_005fsummary-usage">plot_summary usage</a>: plot_summary help/usage (<samp><span class="option">--help</span></samp>)
-<li><a accesskey="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
-<li><a accesskey="5" href="#plot_005fsummary-plot_002dterm">plot_summary plot-term</a>: plot-term option
-<li><a accesskey="6" href="#plot_005fsummary-output_002dfile">plot_summary output-file</a>: output-file option
-<li><a accesskey="7" href="#plot_005fsummary-exit-status">plot_summary exit status</a>: exit status
-</ul>
-
-<div class="node">
-<a name="plot_summary-usage"></a>
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• <a href="#plot_005fsummary-usage" accesskey="1">plot_summary usage</a>:</td><td> </td><td align="left" valign="top">plot_summary help/usage (<samp>--help</samp>)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#plot_005fsummary-directory" accesskey="2">plot_summary directory</a>:</td><td> </td><td align="left" valign="top">directory option
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#plot_005fsummary-identifier" accesskey="3">plot_summary identifier</a>:</td><td> </td><td align="left" valign="top">identifier option
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#plot_005fsummary-peer" accesskey="4">plot_summary peer</a>:</td><td> </td><td align="left" valign="top">peer option
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#plot_005fsummary-plot_002dterm" accesskey="5">plot_summary plot-term</a>:</td><td> </td><td align="left" valign="top">plot-term option
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#plot_005fsummary-output_002dfile" accesskey="6">plot_summary output-file</a>:</td><td> </td><td align="left" valign="top">output-file option
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#plot_005fsummary-exit-status" accesskey="7">plot_summary exit status</a>:</td><td> </td><td align="left" valign="top">exit status
+</td></tr>
+</table>
+
+<hr>
<a name="plot_005fsummary-usage"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#plot_005fsummary-directory" accesskey="n" rel="next">plot_summary directory</a>, Up: <a href="#plot_005fsummary-Invocation" accesskey="u" rel="up">plot_summary Invocation</a> </p>
</div>
-
-<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
-(<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.
+<a name="plot_005fsummary-help_002fusage-_0028_002d_002dhelp_0029"></a>
+<h3 class="section">1.1 plot_summary help/usage (<samp>--help</samp>)</h3>
+<a name="index-plot_005fsummary-help"></a>
+
+<p>This is the automatically generated usage text for plot_summary.
+</p>
+<p>The text printed is the same whether selected with the <code>help</code> option
+(<samp>--help</samp>) or the <code>more-help</code> option (<samp>--more-help</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 <samp><span class="file">more</span></samp>. Both will exit
+used to select the program, defaulting to <samp>more</samp>. Both will exit
with a status code of 0.
-
-<pre class="example">plot_summary - plot statistics generated by summary script - Ver. 4.2.8p13
-USAGE: plot_summary [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
+</p>
+<div class="example">
+<pre class="example">plot_summary - plot statistics generated by summary script - Ver. 4.2.8p13-foo
+USAGE: plot_summary [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
--directory=str Where the summary files are
--identifier=str Origin of the data
Options are specified by doubled hyphens and their name or by a single
hyphen and the flag character.
-</pre>
- <div class="node">
-<a name="plot_summary-directory"></a>
+</pre></div>
+
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• <a href="#plot_005fsummary-directory" accesskey="1">plot_summary directory</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#plot_005fsummary-identifier" accesskey="2">plot_summary identifier</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#plot_005fsummary-peer" accesskey="3">plot_summary peer</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#plot_005fsummary-plot_002dterm" accesskey="4">plot_summary plot-term</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#plot_005fsummary-output_002dfile" accesskey="5">plot_summary output-file</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#plot_005fsummary-exit-status" accesskey="6">plot_summary exit status</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+</table>
+
+<hr>
<a name="plot_005fsummary-directory"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#plot_005fsummary-identifier" accesskey="n" rel="next">plot_summary identifier</a>, Previous: <a href="#plot_005fsummary-usage" accesskey="p" rel="prev">plot_summary usage</a>, Up: <a href="#plot_005fsummary-usage" accesskey="u" rel="up">plot_summary usage</a> </p>
</div>
+<a name="directory-option"></a>
+<h4 class="subsection">1.1.1 directory option</h4>
+<a name="index-plot_005fsummary_002ddirectory"></a>
-<h4 class="subsection">directory option</h4>
-
-<p><a name="index-plot_005fsummary_002ddirectory-4"></a>
-This is the “where the summary files are” option.
-This option takes a string argument.
+<p>This is the “where the summary files are” option.
+This option takes a string argument.
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>
+ *_summary files generated by <code>summary</code> script.
+</p><hr>
<a name="plot_005fsummary-identifier"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#plot_005fsummary-peer" accesskey="n" rel="next">plot_summary peer</a>, Previous: <a href="#plot_005fsummary-directory" accesskey="p" rel="prev">plot_summary directory</a>, Up: <a href="#plot_005fsummary-usage" accesskey="u" rel="up">plot_summary usage</a> </p>
</div>
+<a name="identifier-option"></a>
+<h4 class="subsection">1.1.2 identifier option</h4>
+<a name="index-plot_005fsummary_002didentifier"></a>
-<h4 class="subsection">identifier option</h4>
-
-<p><a name="index-plot_005fsummary_002didentifier-5"></a>
-This is the “origin of the data” option.
-This option takes a string argument.
- Where does the plotted data come from, default to string "host" plus
+<p>This is the “origin of the data” option.
+This option takes a string argument.
+ Where does the plotted data come from, default to string "host" plus
current hostname
-<div class="node">
-<a name="plot_summary-peer"></a>
+</p><hr>
<a name="plot_005fsummary-peer"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#plot_005fsummary-plot_002dterm" accesskey="n" rel="next">plot_summary plot-term</a>, Previous: <a href="#plot_005fsummary-identifier" accesskey="p" rel="prev">plot_summary identifier</a>, Up: <a href="#plot_005fsummary-usage" accesskey="u" rel="up">plot_summary usage</a> </p>
</div>
+<a name="peer-option"></a>
+<h4 class="subsection">1.1.3 peer option</h4>
+<a name="index-plot_005fsummary_002dpeer"></a>
-<h4 class="subsection">peer option</h4>
-
-<p><a name="index-plot_005fsummary_002dpeer-6"></a>
-This is the “peers to generate plots for” option.
+<p>This is the “peers to generate plots for” option.
This option takes a string argument.
-
-<p class="noindent">This option has some usage constraints. It:
- <ul>
-<li>may appear an unlimited number of times.
-</ul>
-
- <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>
+</p>
+<p>This option has some usage constraints. It:
+</p><ul>
+<li> may appear an unlimited number of times.
+</li></ul>
+
+<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.
+</p><hr>
<a name="plot_005fsummary-plot_002dterm"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#plot_005fsummary-output_002dfile">plot_summary output-file</a>,
-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>
-
+<div class="header">
+<p>
+Next: <a href="#plot_005fsummary-output_002dfile" accesskey="n" rel="next">plot_summary output-file</a>, Previous: <a href="#plot_005fsummary-peer" accesskey="p" rel="prev">plot_summary peer</a>, Up: <a href="#plot_005fsummary-usage" accesskey="u" rel="up">plot_summary usage</a> </p>
</div>
+<a name="plot_002dterm-option"></a>
+<h4 class="subsection">1.1.4 plot-term option</h4>
+<a name="index-plot_005fsummary_002dplot_002dterm"></a>
-<h4 class="subsection">plot-term option</h4>
-
-<p><a name="index-plot_005fsummary_002dplot_002dterm-7"></a>
-This is the “gnuplot terminal” option.
-This option takes a string argument.
+<p>This is the “gnuplot terminal” option.
+This option takes a string argument.
This is string is passed directly to the <code>gnuplot set terminal</code>
command. Default is <code>x11</code> if <code>DISPLAY</code> is set and
- <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>
+ <code>dumb</code> is it’s not’. See output from (gnuplot -e "set
+ terminal") for the list of available options.
+</p><hr>
<a name="plot_005fsummary-output_002dfile"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#plot_005fsummary-exit-status">plot_summary exit status</a>,
-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>
-
+<div class="header">
+<p>
+Next: <a href="#plot_005fsummary-exit-status" accesskey="n" rel="next">plot_summary exit status</a>, Previous: <a href="#plot_005fsummary-plot_002dterm" accesskey="p" rel="prev">plot_summary plot-term</a>, Up: <a href="#plot_005fsummary-usage" accesskey="u" rel="up">plot_summary usage</a> </p>
</div>
-
-<h4 class="subsection">output-file option</h4>
-
-<p><a name="index-plot_005fsummary_002doutput_002dfile-8"></a>
-This is the “output file” option.
-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="output_002dfile-option"></a>
+<h4 class="subsection">1.1.5 output-file option</h4>
+<a name="index-plot_005fsummary_002doutput_002dfile"></a>
+
+<p>This is the “output file” option.
+This option takes a str argument.
+ Output file for <code>gnuplot</code>, default to stdout.
+</p><hr>
<a name="plot_005fsummary-exit-status"></a>
-<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#plot_005fsummary-output_002dfile">plot_summary output-file</a>,
-Up: <a rel="up" accesskey="u" href="#plot_005fsummary-Invocation">plot_summary Invocation</a>
-
+<div class="header">
+<p>
+Previous: <a href="#plot_005fsummary-output_002dfile" accesskey="p" rel="prev">plot_summary output-file</a>, Up: <a href="#plot_005fsummary-usage" accesskey="u" rel="up">plot_summary usage</a> </p>
</div>
-
-<h4 class="subsection">plot_summary exit status</h4>
+<a name="plot_005fsummary-exit-status-1"></a>
+<h4 class="subsection">1.1.6 plot_summary exit status</h4>
<p>One of the following exit values will be returned:
- <dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
+</p><dl compact="compact">
+<dt>‘<samp>0 (EXIT_SUCCESS)</samp>’</dt>
+<dd><p>Successful program execution.
+</p></dd>
+<dt>‘<samp>1 (EXIT_FAILURE)</samp>’</dt>
+<dd><p>The operation failed or the command syntax was not valid.
+</p></dd>
</dl>
+<hr>
+
-</body></html>
+</body>
+</html>
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH plot_summary 1plot_summaryman "04 Feb 2020" "ntp (4.2.8p13)" "User Commands"
+.TH plot_summary 1plot_summaryman "03 Mar 2020" "ntp (4.2.8p13-foo)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:31 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:12 PM by AutoGen 5.18.5
.\" From the definitions plot_summary-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt PLOT_SUMMARY 1plot_summarymdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (plot_summary-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:32 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:13 PM by AutoGen 5.18.5
.\" From the definitions plot_summary-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
# EDIT THIS FILE WITH CAUTION (summary-opts)
#
-# It has been AutoGen-ed February 4, 2020 at 11:52:29 PM by AutoGen 5.18.5
+# It has been AutoGen-ed March 3, 2020 at 04:34:11 PM by AutoGen 5.18.5
# From the definitions summary-opts.def
# and the template file perlopt
'help|?', 'more-help'));
$usage = <<'USAGE';
-summary - compute various stastics from NTP stat files - Ver. 4.2.8p13
+summary - compute various stastics from NTP stat files - Ver. 4.2.8p13-foo
USAGE: summary [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
--directory=str Directory containing stat files
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH summary 1summaryman "04 Feb 2020" "ntp (4.2.8p13)" "User Commands"
+.TH summary 1summaryman "03 Mar 2020" "ntp (4.2.8p13-foo)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:35 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:16 PM by AutoGen 5.18.5
.\" From the definitions summary-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt SUMMARY 1summarymdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (summary-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:36 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:17 PM by AutoGen 5.18.5
.\" From the definitions summary-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
-<html lang="en">
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
-<title>Summary User's Manual</title>
-<meta http-equiv="Content-Type" content="text/html">
-<meta name="description" content="Summary User's Manual">
-<meta name="generator" content="makeinfo 4.13">
-<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">
-<style type="text/css"><!--
- pre.display { font-family:inherit }
- pre.format { font-family:inherit }
- pre.smalldisplay { font-family:inherit; font-size:smaller }
- pre.smallformat { font-family:inherit; font-size:smaller }
- pre.smallexample { font-size:smaller }
- pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family:serif; font-weight:normal; }
- span.sansserif { font-family:sans-serif; font-weight:normal; }
---></style>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<title>Summary User’s Manual</title>
+
+<meta name="description" content="Summary User’s Manual">
+<meta name="keywords" content="Summary User’s Manual">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<link href="#Top" rel="start" title="Top">
+<link href="dir.html#Top" rel="up" title="(dir)">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+blockquote.indentedblock {margin-right: 0em}
+blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
+blockquote.smallquotation {font-size: smaller}
+div.display {margin-left: 3.2em}
+div.example {margin-left: 3.2em}
+div.lisp {margin-left: 3.2em}
+div.smalldisplay {margin-left: 3.2em}
+div.smallexample {margin-left: 3.2em}
+div.smalllisp {margin-left: 3.2em}
+kbd {font-style: oblique}
+pre.display {font-family: inherit}
+pre.format {font-family: inherit}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: inherit; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: inherit; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.nolinebreak {white-space: nowrap}
+span.roman {font-family: initial; font-weight: normal}
+span.sansserif {font-family: sans-serif; font-weight: normal}
+ul.no-bullet {list-style: none}
+-->
+</style>
+
+
</head>
-<body>
-<h1 class="settitle">Summary User's Manual</h1>
-<div class="node">
-<a name="Top"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#summary-Description">summary Description</a>,
-Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>,
-Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
-</div>
+<body lang="en">
+<h1 class="settitle" align="center">Summary User’s Manual</h1>
-<h2 class="unnumbered">Summary User Manual</h2>
-<p>This document describes the use of the NTP Project's <code>summary</code> program.
-This document applies to version 4.2.8p13 of <code>summary</code>.
- <div class="shortcontents">
-<h2>Short Contents</h2>
-<ul>
-<a href="#Top">Summary User Manual</a>
+
+
+<a name="Top"></a>
+<div class="header">
+<p>
+Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> </p>
+</div>
+<a name="Summary-User-Manual"></a>
+<h1 class="top">Summary User Manual</h1>
+
+<p>This document describes the use of the NTP Project’s <code>summary</code> program.
+This document applies to version 4.2.8p13-foo of <code>summary</code>.
+</p>
+<a name="SEC_Overview"></a>
+<h2 class="shortcontents-heading">Short Table of Contents</h2>
+
+<div class="shortcontents">
+<ul class="no-bullet">
+<li><a name="stoc-Invoking-summary" href="#toc-Invoking-summary">1 Invoking summary</a></li>
</ul>
</div>
-<ul class="menu">
-<li><a accesskey="1" href="#summary-Description">summary Description</a>: Description
-<li><a accesskey="2" href="#summary-Invocation">summary Invocation</a>: Invoking summary
-</ul>
-<div class="node">
-<a name="summary-Invocation"></a>
-<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#summary-Description">summary Description</a>,
-Up: <a rel="up" accesskey="u" href="#Top">Top</a>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• summary Description:</td><td> </td><td align="left" valign="top">Description
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#summary-Invocation" accesskey="2">summary Invocation</a>:</td><td> </td><td align="left" valign="top">Invoking summary
+</td></tr>
+</table>
+<hr>
+<a name="summary-Invocation"></a>
+<div class="header">
+<p>
+Up: <a href="#Top" accesskey="u" rel="up">Top</a> </p>
</div>
+<a name="Invoking-summary"></a>
+<h2 class="chapter">1 Invoking summary</h2>
+<a name="index-summary"></a>
+<a name="index-compute-various-stastics-from-NTP-stat-files"></a>
-<h3 class="section">Invoking summary</h3>
-
-<p><a name="index-summary-1"></a><a name="index-compute-various-stastics-from-NTP-stat-files-2"></a>
- <p>This section was generated by <strong>AutoGen</strong>,
-using the <code>agtexi-cmd</code> template and the option descriptions for the <code>summary</code> program.
-<ul class="menu">
-<li><a accesskey="1" href="#summary-usage">summary usage</a>: summary help/usage (<samp><span class="option">--help</span></samp>)
-<li><a accesskey="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
-<li><a accesskey="5" href="#summary-start_002ddate">summary start-date</a>: start-date option
-<li><a accesskey="6" href="#summary-exit-status">summary exit status</a>: exit status
-</ul>
-<div class="node">
+<p>This section was generated by <strong>AutoGen</strong>,
+using the <code>agtexi-cmd</code> template and the option descriptions for the <code>summary</code> program.
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• <a href="#summary-usage" accesskey="1">summary usage</a>:</td><td> </td><td align="left" valign="top">summary help/usage (<samp>--help</samp>)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#summary-directory" accesskey="2">summary directory</a>:</td><td> </td><td align="left" valign="top">directory option
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#summary-end_002ddate" accesskey="3">summary end-date</a>:</td><td> </td><td align="left" valign="top">end-date option
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#summary-output_002ddirectory" accesskey="4">summary output-directory</a>:</td><td> </td><td align="left" valign="top">output-directory option
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#summary-start_002ddate" accesskey="5">summary start-date</a>:</td><td> </td><td align="left" valign="top">start-date option
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#summary-exit-status" accesskey="6">summary exit status</a>:</td><td> </td><td align="left" valign="top">exit status
+</td></tr>
+</table>
+
+<hr>
<a name="summary-usage"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#summary-directory">summary directory</a>,
-Up: <a rel="up" accesskey="u" href="#summary-Invocation">summary Invocation</a>
-
+<div class="header">
+<p>
+Next: <a href="#summary-directory" accesskey="n" rel="next">summary directory</a>, Up: <a href="#summary-Invocation" accesskey="u" rel="up">summary Invocation</a> </p>
</div>
-
-<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
-(<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.
+<a name="summary-help_002fusage-_0028_002d_002dhelp_0029"></a>
+<h3 class="section">1.1 summary help/usage (<samp>--help</samp>)</h3>
+<a name="index-summary-help"></a>
+
+<p>This is the automatically generated usage text for summary.
+</p>
+<p>The text printed is the same whether selected with the <code>help</code> option
+(<samp>--help</samp>) or the <code>more-help</code> option (<samp>--more-help</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 <samp><span class="file">more</span></samp>. Both will exit
+used to select the program, defaulting to <samp>more</samp>. Both will exit
with a status code of 0.
-
-<pre class="example">summary - compute various stastics from NTP stat files - Ver. 4.2.8p13
-USAGE: summary [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
+</p>
+<div class="example">
+<pre class="example">summary - compute various stastics from NTP stat files - Ver. 4.2.8p13-foo
+USAGE: summary [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
--directory=str Directory containing stat files
--end-date=num End date
Options are specified by doubled hyphens and their name or by a single
hyphen and the flag character.
-</pre>
- <div class="node">
+</pre></div>
+
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• <a href="#summary-directory" accesskey="1">summary directory</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#summary-end_002ddate" accesskey="2">summary end-date</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#summary-output_002ddirectory" accesskey="3">summary output-directory</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#summary-start_002ddate" accesskey="4">summary start-date</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#summary-exit-status" accesskey="5">summary exit status</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+</table>
+
+<hr>
<a name="summary-directory"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#summary-end_002ddate" accesskey="n" rel="next">summary end-date</a>, Previous: <a href="#summary-usage" accesskey="p" rel="prev">summary usage</a>, Up: <a href="#summary-usage" accesskey="u" rel="up">summary usage</a> </p>
</div>
+<a name="directory-option"></a>
+<h4 class="subsection">1.1.1 directory option</h4>
+<a name="index-summary_002ddirectory"></a>
-<h4 class="subsection">directory option</h4>
-
-<p><a name="index-summary_002ddirectory-4"></a>
-This is the “directory containing stat files” option.
-This option takes a string argument.
+<p>This is the “directory containing stat files” option.
+This option takes a string argument.
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>
+ by <code>ntpd</code>.
+</p><hr>
<a name="summary-end_002ddate"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#summary-output_002ddirectory" accesskey="n" rel="next">summary output-directory</a>, Previous: <a href="#summary-directory" accesskey="p" rel="prev">summary directory</a>, Up: <a href="#summary-usage" accesskey="u" rel="up">summary usage</a> </p>
</div>
+<a name="end_002ddate-option"></a>
+<h4 class="subsection">1.1.2 end-date option</h4>
+<a name="index-summary_002dend_002ddate"></a>
-<h4 class="subsection">end-date option</h4>
-
-<p><a name="index-summary_002dend_002ddate-5"></a>
-This is the “end date” option.
-This option takes a number argument.
+<p>This is the “end date” option.
+This option takes a number argument.
Process all files with the date suffix less or equal to value of this
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>
+ to get the timestamp.
+</p><hr>
<a name="summary-output_002ddirectory"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#summary-start_002ddate" accesskey="n" rel="next">summary start-date</a>, Previous: <a href="#summary-end_002ddate" accesskey="p" rel="prev">summary end-date</a>, Up: <a href="#summary-usage" accesskey="u" rel="up">summary usage</a> </p>
</div>
-
-<h4 class="subsection">output-directory option</h4>
-
-<p><a name="index-summary_002doutput_002ddirectory-6"></a>
-This is the “output directory” option.
-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="output_002ddirectory-option"></a>
+<h4 class="subsection">1.1.3 output-directory option</h4>
+<a name="index-summary_002doutput_002ddirectory"></a>
+
+<p>This is the “output directory” option.
+This option takes a str argument.
+ The output directory <code>summary</code> will write all output files to.
+</p><hr>
<a name="summary-start_002ddate"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#summary-exit-status" accesskey="n" rel="next">summary exit status</a>, Previous: <a href="#summary-output_002ddirectory" accesskey="p" rel="prev">summary output-directory</a>, Up: <a href="#summary-usage" accesskey="u" rel="up">summary usage</a> </p>
</div>
+<a name="start_002ddate-option"></a>
+<h4 class="subsection">1.1.4 start-date option</h4>
+<a name="index-summary_002dstart_002ddate"></a>
-<h4 class="subsection">start-date option</h4>
-
-<p><a name="index-summary_002dstart_002ddate-7"></a>
-This is the “start date” option.
-This option takes a num argument.
+<p>This is the “start date” option.
+This option takes a num argument.
Process all files with the date suffix more or equal to value of
- this option. Defaults to 197000101.
-<div class="node">
+ this option. Defaults to 197000101.
+</p><hr>
<a name="summary-exit-status"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Previous: <a href="#summary-start_002ddate" accesskey="p" rel="prev">summary start-date</a>, Up: <a href="#summary-usage" accesskey="u" rel="up">summary usage</a> </p>
</div>
-
-<h4 class="subsection">summary exit status</h4>
+<a name="summary-exit-status-1"></a>
+<h4 class="subsection">1.1.5 summary exit status</h4>
<p>One of the following exit values will be returned:
- <dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
+</p><dl compact="compact">
+<dt>‘<samp>0 (EXIT_SUCCESS)</samp>’</dt>
+<dd><p>Successful program execution.
+</p></dd>
+<dt>‘<samp>1 (EXIT_FAILURE)</samp>’</dt>
+<dd><p>The operation failed or the command syntax was not valid.
+</p></dd>
</dl>
+<hr>
+
-</body></html>
+</body>
+</html>
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH summary 1summaryman "04 Feb 2020" "ntp (4.2.8p13)" "User Commands"
+.TH summary 1summaryman "03 Mar 2020" "ntp (4.2.8p13-foo)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:35 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:16 PM by AutoGen 5.18.5
.\" From the definitions summary-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt SUMMARY 1summarymdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (summary-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:36 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:17 PM by AutoGen 5.18.5
.\" From the definitions summary-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-update-leap.texi)
#
-# It has been AutoGen-ed February 4, 2020 at 11:52:26 PM by AutoGen 5.18.5
+# It has been AutoGen-ed March 3, 2020 at 04:34:08 PM by AutoGen 5.18.5
# From the definitions update-leap-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
# EDIT THIS FILE WITH CAUTION (update-leap-opts)
#
-# It has been AutoGen-ed February 4, 2020 at 11:52:29 PM by AutoGen 5.18.5
+# It has been AutoGen-ed March 3, 2020 at 04:34:11 PM by AutoGen 5.18.5
# From the definitions update-leap-opts.def
# and the template file perlopt
'help|?', 'more-help'));
$usage = <<'USAGE';
-update-leap - leap-seconds file manager/updater - Ver. 4.2.8p13
+update-leap - leap-seconds file manager/updater - Ver. 4.2.8p13-foo
USAGE: update-leap [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
-s, --source-url=str The URL of the master copy of the leapseconds file
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH update-leap 1update-leapman "04 Feb 2020" "ntp (4.2.8p13)" "User Commands"
+.TH update-leap 1update-leapman "03 Mar 2020" "ntp (4.2.8p13-foo)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:28 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:10 PM by AutoGen 5.18.5
.\" From the definitions update-leap-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt UPDATE_LEAP 1update-leapmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (update-leap-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:25 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:07 PM by AutoGen 5.18.5
.\" From the definitions update-leap-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
<p>This document describes the use of the NTP Project’s <code>update-leap</code> program.
</p>
-<p>This document applies to version 4.2.8p13 of <code>update-leap</code>.
+<p>This document applies to version 4.2.8p13-foo of <code>update-leap</code>.
</p>
<a name="SEC_Overview"></a>
<h2 class="shortcontents-heading">Short Table of Contents</h2>
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH update-leap 1update-leapman "04 Feb 2020" "ntp (4.2.8p13)" "User Commands"
+.TH update-leap 1update-leapman "03 Mar 2020" "ntp (4.2.8p13-foo)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:28 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:10 PM by AutoGen 5.18.5
.\" From the definitions update-leap-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt UPDATE_LEAP 1update-leapmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (update-leap-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:25 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:07 PM by AutoGen 5.18.5
.\" From the definitions update-leap-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-sntp.texi)
#
-# It has been AutoGen-ed February 4, 2020 at 11:52:44 PM by AutoGen 5.18.5
+# It has been AutoGen-ed March 3, 2020 at 04:34:52 PM by AutoGen 5.18.5
# From the definitions sntp-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
/*
* EDIT THIS FILE WITH CAUTION (sntp-opts.c)
*
- * It has been AutoGen-ed February 4, 2020 at 11:52:38 PM by AutoGen 5.18.5
+ * It has been AutoGen-ed March 3, 2020 at 04:34:48 PM by AutoGen 5.18.5
* From the definitions sntp-opts.def
* and the template file options
*
- * Generated from AutoOpts 41:0:16 templates.
+ * Generated from AutoOpts 41:1:16 templates.
*
* AutoOpts is a copyrighted work. This source file is not encumbered
* by AutoOpts licensing, but is provided under the licensing terms chosen
/*
* EDIT THIS FILE WITH CAUTION (sntp-opts.h)
*
- * It has been AutoGen-ed February 4, 2020 at 11:52:38 PM by AutoGen 5.18.5
+ * It has been AutoGen-ed March 3, 2020 at 04:34:48 PM by AutoGen 5.18.5
* From the definitions sntp-opts.def
* and the template file options
*
- * Generated from AutoOpts 41:0:16 templates.
+ * Generated from AutoOpts 41:1:16 templates.
*
* AutoOpts is a copyrighted work. This header file is not encumbered
* by AutoOpts licensing, but is provided under the licensing terms chosen
* tolerable version is at least as old as what was current when the header
* template was released.
*/
-#define AO_TEMPLATE_VERSION 167936
+#define AO_TEMPLATE_VERSION 167937
#if (AO_TEMPLATE_VERSION < OPTIONS_MINIMUM_VERSION) \
|| (AO_TEMPLATE_VERSION > OPTIONS_STRUCT_VERSION)
# error option template version mismatches autoopts/options.h header
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH sntp 1sntpman "04 Feb 2020" "4.2.8p13" "User Commands"
+.TH sntp 1sntpman "03 Mar 2020" "4.2.8p13" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:45 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:53 PM by AutoGen 5.18.5
.\" From the definitions sntp-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt SNTP 1sntpmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (sntp-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:42 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:50 PM by AutoGen 5.18.5
.\" From the definitions sntp-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
-<html lang="en">
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
-<title>Sntp User's Manual</title>
-<meta http-equiv="Content-Type" content="text/html">
-<meta name="description" content="Sntp User's Manual">
-<meta name="generator" content="makeinfo 4.13">
-<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">
-<style type="text/css"><!--
- pre.display { font-family:inherit }
- pre.format { font-family:inherit }
- pre.smalldisplay { font-family:inherit; font-size:smaller }
- pre.smallformat { font-family:inherit; font-size:smaller }
- pre.smallexample { font-size:smaller }
- pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family:serif; font-weight:normal; }
- span.sansserif { font-family:sans-serif; font-weight:normal; }
---></style>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<title>Sntp User’s Manual</title>
+
+<meta name="description" content="Sntp User’s Manual">
+<meta name="keywords" content="Sntp User’s Manual">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<link href="#Top" rel="start" title="Top">
+<link href="dir.html#Top" rel="up" title="(dir)">
+<style type="text/css">
+<!--
+a.summary-letter {text-decoration: none}
+blockquote.indentedblock {margin-right: 0em}
+blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
+blockquote.smallquotation {font-size: smaller}
+div.display {margin-left: 3.2em}
+div.example {margin-left: 3.2em}
+div.lisp {margin-left: 3.2em}
+div.smalldisplay {margin-left: 3.2em}
+div.smallexample {margin-left: 3.2em}
+div.smalllisp {margin-left: 3.2em}
+kbd {font-style: oblique}
+pre.display {font-family: inherit}
+pre.format {font-family: inherit}
+pre.menu-comment {font-family: serif}
+pre.menu-preformatted {font-family: serif}
+pre.smalldisplay {font-family: inherit; font-size: smaller}
+pre.smallexample {font-size: smaller}
+pre.smallformat {font-family: inherit; font-size: smaller}
+pre.smalllisp {font-size: smaller}
+span.nolinebreak {white-space: nowrap}
+span.roman {font-family: initial; font-weight: normal}
+span.sansserif {font-family: sans-serif; font-weight: normal}
+ul.no-bullet {list-style: none}
+-->
+</style>
+
+
</head>
-<body>
-<h1 class="settitle">Sntp User's Manual</h1>
-<div class="node">
-<a name="Top"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#sntp-Description">sntp Description</a>,
-Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>,
-Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
-</div>
+<body lang="en">
+<h1 class="settitle" align="center">Sntp User’s Manual</h1>
+
+
+
-<h2 class="unnumbered">Simple Network Time Protocol User Manual</h2>
-<p>This document describes the use of the NTP Project's <code>sntp</code> program,
+<a name="Top"></a>
+<div class="header">
+<p>
+Next: <a href="#sntp-Description" accesskey="n" rel="next">sntp Description</a>, Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> </p>
+</div>
+<a name="Simple-Network-Time-Protocol-User-Manual"></a>
+<h1 class="top">Simple Network Time Protocol User Manual</h1>
+
+<p>This document describes the use of the NTP Project’s <code>sntp</code> program,
that can be used to query a Network Time Protocol (NTP) server and
display the time offset of the system clock relative to the server
clock. Run as root, it can correct the system clock to this offset as
well. It can be run as an interactive command or from a cron job.
-
-
<p>This document applies to version 4.2.8p13 of <code>sntp</code>.
-
-
<p>The program implements the SNTP protocol as defined by RFC 5905, the NTPv4
+</p>
+<p>This document applies to version 4.2.8p13 of <code>sntp</code>.
+</p>
+<p>The program implements the SNTP protocol as defined by RFC 5905, the NTPv4
IETF specification.
+</p>
+<a name="SEC_Overview"></a>
+<h2 class="shortcontents-heading">Short Table of Contents</h2>
- <div class="shortcontents">
-<h2>Short Contents</h2>
-<ul>
-<a href="#Top">Simple Network Time Protocol User Manual</a>
+<div class="shortcontents">
+<ul class="no-bullet">
+<li><a name="stoc-Description" href="#toc-Description">1 Description</a></li>
</ul>
</div>
-<ul class="menu">
-<li><a accesskey="1" href="#sntp-Description">sntp Description</a>: Description
-<li><a accesskey="2" href="#sntp-Invocation">sntp Invocation</a>: Invoking sntp
-<li><a accesskey="3" href="#Usage">Usage</a>: Usage
-</ul>
-
-<div class="node">
-<a name="sntp-Description"></a>
-<p><hr>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• <a href="#sntp-Description" accesskey="1">sntp Description</a>:</td><td> </td><td align="left" valign="top">Description
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#sntp-Invocation" accesskey="2">sntp Invocation</a>:</td><td> </td><td align="left" valign="top">Invoking sntp
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#Usage" accesskey="3">Usage</a>:</td><td> </td><td align="left" valign="top">Usage
+</td></tr>
+</table>
+<hr>
+<a name="sntp-Description"></a>
+<div class="header">
+<p>
+Next: <a href="#sntp-Invocation" accesskey="n" rel="next">sntp Invocation</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> </p>
</div>
-
-<!-- node-name, next, previous, up -->
-<h3 class="section">Description</h3>
+<a name="Description"></a>
+<h2 class="chapter">1 Description</h2>
<p>By default, <code>sntp</code> writes the local data and time (i.e., not UTC) to the
standard output in the format:
+</p>
+<div class="example">
+<pre class="example">1996-10-15 20:17:25.123 (+0800) +4.567 +/- 0.089 secs
+</pre></div>
-<pre class="example"> 1996-10-15 20:17:25.123 (+0800) +4.567 +/- 0.089 secs
-</pre>
- <p>where
+<p>where
YYYY-MM-DD HH:MM:SS.SUBSEC is the local date and time,
(+0800) is the local timezone adjustment (so we would add 8 hours and 0 minutes to convert the reported local time to UTC),
and
the +4.567 +/- 0.089 secs indicates the time offset and
error bound of the system clock relative to the server clock.
-
-<div class="node">
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• <a href="#sntp-Invocation" accesskey="1">sntp Invocation</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#Usage" accesskey="2">Usage</a>:</td><td> </td><td align="left" valign="top">
+</td></tr>
+</table>
+
+<hr>
<a name="sntp-Invocation"></a>
-<p><hr>
-
-
+<div class="header">
+<p>
+Next: <a href="#Usage" accesskey="n" rel="next">Usage</a>, Previous: <a href="#sntp-Description" accesskey="p" rel="prev">sntp Description</a>, Up: <a href="#sntp-Description" accesskey="u" rel="up">sntp Description</a> </p>
</div>
+<a name="Invoking-sntp"></a>
+<h3 class="section">1.1 Invoking sntp</h3>
+<a name="index-sntp"></a>
+<a name="index-standard-Simple-Network-Time-Protocol-client-program"></a>
-<h3 class="section">Invoking sntp</h3>
-<p><a name="index-sntp-1"></a><a name="index-standard-Simple-Network-Time-Protocol-client-program-2"></a>
+<p><code>sntp</code>
can be used as an SNTP client to query a NTP or SNTP server and either display
-the time or set the local system's time (given suitable privilege). It can be
+the time or set the local system’s time (given suitable privilege). It can be
run as an interactive command or from a
<code>cron</code>
job.
-
-
<p>NTP (the Network Time Protocol) and SNTP (the Simple Network Time Protocol)
+</p>
+<p>NTP (the Network Time Protocol) and SNTP (the Simple Network Time Protocol)
are defined and described by RFC 5905.
+</p>
-
<p>The default is to write the estimated correct local date and time (i.e. not
+<p>The default is to write the estimated correct local date and time (i.e. not
UTC) to the standard output in a format like:
-
-
<p><code>'1996-10-15 20:17:25.123 (+0800) +4.567 +/- 0.089 [host] IP sN'</code>
-
+</p>
+<p><code>'1996-10-15 20:17:25.123 (+0800) +4.567 +/- 0.089 [host] IP sN'</code>
+</p>
+<p>where the
<code>'(+0800)'</code>
means that to get to UTC from the reported local time one must
add 8 hours and 0 minutes,
the
<code>'+4.567'</code>
indicates the local clock is 4.567 seconds behind the correct time
-(so 4.567 seconds must be added to the local clock to get it to be correct).
+(so 4.567 seconds must be added to the local clock to get it to be correct).
Note that the number of decimals printed for this value will change
-based on the reported precision of the server.
+based on the reported precision of the server.
<code>'+/- 0.089'</code>
is the reported
<em>synchronization</em> <em>distance</em>
-(in seconds), which represents the maximum error due to all causes.
+(in seconds), which represents the maximum error due to all causes.
If the server does not report valid data needed to calculate the
synchronization distance, this will be reported as
-<code>'+/- ?'</code>.
+<code>'+/- ?'</code>.
If the
<em>host</em>
is different from the
<em>IP</em>,
-both will be displayed.
-Otherwise, only the
+both will be displayed.
+Otherwise, only the
<em>IP</em>
-is displayed.
+is displayed.
Finally, the
<em>stratum</em>
of the host is reported
and the leap indicator is decoded and displayed.
-
-
<p>This section was generated by <strong>AutoGen</strong>,
-using the <code>agtexi-cmd</code> template and the option descriptions for the <code>sntp</code> program.
+</p>
+<p>This section was generated by <strong>AutoGen</strong>,
+using the <code>agtexi-cmd</code> template and the option descriptions for the <code>sntp</code> program.
This software is released under the NTP license, <http://ntp.org/license>.
-
-<ul class="menu">
-<li><a accesskey="1" href="#sntp-usage">sntp usage</a>: sntp help/usage (<samp><span class="option">--help</span></samp>)
-<li><a accesskey="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)
-<li><a accesskey="5" href="#sntp-broadcast">sntp broadcast</a>: broadcast option (-b)
-<li><a accesskey="6" href="#sntp-concurrent">sntp concurrent</a>: concurrent option (-c)
-<li><a accesskey="7" href="#sntp-gap">sntp gap</a>: gap option (-g)
-<li><a accesskey="8" href="#sntp-kod">sntp kod</a>: kod option (-K)
-<li><a accesskey="9" href="#sntp-keyfile">sntp keyfile</a>: keyfile option (-k)
-<li><a href="#sntp-logfile">sntp logfile</a>: logfile option (-l)
-<li><a href="#sntp-steplimit">sntp steplimit</a>: steplimit option (-M)
-<li><a href="#sntp-ntpversion">sntp ntpversion</a>: ntpversion option (-o)
-<li><a href="#sntp-usereservedport">sntp usereservedport</a>: usereservedport option (-r)
-<li><a href="#sntp-timeout">sntp timeout</a>: timeout option (-t)
-<li><a href="#sntp-wait">sntp wait</a>: wait option
-<li><a href="#sntp-config">sntp config</a>: presetting/configuring sntp
-<li><a href="#sntp-exit-status">sntp exit status</a>: exit status
-<li><a href="#sntp-Usage">sntp Usage</a>: Usage
-<li><a href="#sntp-Authors">sntp Authors</a>: Authors
-</ul>
-
-<div class="node">
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">• <a href="#sntp-usage" accesskey="1">sntp usage</a>:</td><td> </td><td align="left" valign="top">sntp help/usage (<samp>--help</samp>)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#sntp-ipv4" accesskey="2">sntp ipv4</a>:</td><td> </td><td align="left" valign="top">ipv4 option (-4)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#sntp-ipv6" accesskey="3">sntp ipv6</a>:</td><td> </td><td align="left" valign="top">ipv6 option (-6)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#sntp-authentication" accesskey="4">sntp authentication</a>:</td><td> </td><td align="left" valign="top">authentication option (-a)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#sntp-broadcast" accesskey="5">sntp broadcast</a>:</td><td> </td><td align="left" valign="top">broadcast option (-b)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#sntp-concurrent" accesskey="6">sntp concurrent</a>:</td><td> </td><td align="left" valign="top">concurrent option (-c)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#sntp-gap" accesskey="7">sntp gap</a>:</td><td> </td><td align="left" valign="top">gap option (-g)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#sntp-kod" accesskey="8">sntp kod</a>:</td><td> </td><td align="left" valign="top">kod option (-K)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#sntp-keyfile" accesskey="9">sntp keyfile</a>:</td><td> </td><td align="left" valign="top">keyfile option (-k)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#sntp-logfile">sntp logfile</a>:</td><td> </td><td align="left" valign="top">logfile option (-l)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#sntp-steplimit">sntp steplimit</a>:</td><td> </td><td align="left" valign="top">steplimit option (-M)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#sntp-ntpversion">sntp ntpversion</a>:</td><td> </td><td align="left" valign="top">ntpversion option (-o)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#sntp-usereservedport">sntp usereservedport</a>:</td><td> </td><td align="left" valign="top">usereservedport option (-r)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#sntp-timeout">sntp timeout</a>:</td><td> </td><td align="left" valign="top">timeout option (-t)
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#sntp-wait">sntp wait</a>:</td><td> </td><td align="left" valign="top">wait option
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#sntp-config">sntp config</a>:</td><td> </td><td align="left" valign="top">presetting/configuring sntp
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#sntp-exit-status">sntp exit status</a>:</td><td> </td><td align="left" valign="top">exit status
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#sntp-Usage">sntp Usage</a>:</td><td> </td><td align="left" valign="top">Usage
+</td></tr>
+<tr><td align="left" valign="top">• <a href="#sntp-Authors">sntp Authors</a>:</td><td> </td><td align="left" valign="top">Authors
+</td></tr>
+</table>
+
+<hr>
<a name="sntp-usage"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#sntp-ipv4">sntp ipv4</a>,
-Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-
+<div class="header">
+<p>
+Next: <a href="#sntp-ipv4" accesskey="n" rel="next">sntp ipv4</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
</div>
-
-<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
-(<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.
+<a name="sntp-help_002fusage-_0028_002d_002dhelp_0029"></a>
+<h4 class="subsection">1.1.1 sntp help/usage (<samp>--help</samp>)</h4>
+<a name="index-sntp-help"></a>
+
+<p>This is the automatically generated usage text for sntp.
+</p>
+<p>The text printed is the same whether selected with the <code>help</code> option
+(<samp>--help</samp>) or the <code>more-help</code> option (<samp>--more-help</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 <samp><span class="file">more</span></samp>. Both will exit
+used to select the program, defaulting to <samp>more</samp>. Both will exit
with a status code of 0.
-
+</p>
+<div class="example">
<pre class="example">sntp - standard Simple Network Time Protocol client program - Ver. 4.2.8p13
Usage: sntp [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \
[ hostname-or-IP ...]
- examining environment variables named SNTP_*
Please send bug reports to: <http://bugs.ntp.org, bugs@ntp.org>
-</pre>
- <div class="node">
-<a name="sntp-ipv4"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#sntp-ipv6">sntp ipv6</a>,
-Previous: <a rel="previous" accesskey="p" href="#sntp-usage">sntp usage</a>,
-Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
+</pre></div>
+<hr>
+<a name="sntp-ipv4"></a>
+<div class="header">
+<p>
+Next: <a href="#sntp-ipv6" accesskey="n" rel="next">sntp ipv6</a>, Previous: <a href="#sntp-usage" accesskey="p" rel="prev">sntp usage</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
</div>
-
-<h4 class="subsection">ipv4 option (-4)</h4>
-
-<p><a name="index-sntp_002dipv4-4"></a>
-This is the “force ipv4 dns name resolution” option.
-
-<p class="noindent">This option has some usage constraints. It:
-<li>must not appear in combination with any of the following options:
-ipv6.
-</ul>
-
-
<p>Force DNS resolution of the following host names on the command line
-to the IPv4 namespace.
-<div class="node">
+<a name="ipv4-option-_0028_002d4_0029"></a>
+<h4 class="subsection">1.1.2 ipv4 option (-4)</h4>
+<a name="index-sntp_002dipv4"></a>
+
+<p>This is the “force ipv4 dns name resolution” option.
+</p>
+<p>This option has some usage constraints. It:
+<li> must not appear in combination with any of the following options:
+ipv6.
+</li></ul>
+
+<p>Force DNS resolution of the following host names on the command line
+to the IPv4 namespace.
+</p><hr>
<a name="sntp-ipv6"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#sntp-authentication" accesskey="n" rel="next">sntp authentication</a>, Previous: <a href="#sntp-ipv4" accesskey="p" rel="prev">sntp ipv4</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
</div>
-
-<h4 class="subsection">ipv6 option (-6)</h4>
-
-<p><a name="index-sntp_002dipv6-5"></a>
-This is the “force ipv6 dns name resolution” option.
-
-<p class="noindent">This option has some usage constraints. It:
-<li>must not appear in combination with any of the following options:
-ipv4.
-</ul>
-
-
<p>Force DNS resolution of the following host names on the command line
-to the IPv6 namespace.
-<div class="node">
+<a name="ipv6-option-_0028_002d6_0029"></a>
+<h4 class="subsection">1.1.3 ipv6 option (-6)</h4>
+<a name="index-sntp_002dipv6"></a>
+
+<p>This is the “force ipv6 dns name resolution” option.
+</p>
+<p>This option has some usage constraints. It:
+<li> must not appear in combination with any of the following options:
+ipv4.
+</li></ul>
+
+<p>Force DNS resolution of the following host names on the command line
+to the IPv6 namespace.
+</p><hr>
<a name="sntp-authentication"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#sntp-broadcast" accesskey="n" rel="next">sntp broadcast</a>, Previous: <a href="#sntp-ipv6" accesskey="p" rel="prev">sntp ipv6</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
</div>
-
-<h4 class="subsection">authentication option (-a)</h4>
-
-<p><a name="index-sntp_002dauthentication-6"></a>
-This is the “enable authentication with the key <var>auth-keynumber</var>” option.
-This option takes a number argument <samp><span class="file">auth-keynumber</span></samp>.
-Enable authentication using the key specified in this option's
-argument. The argument of this option is the <samp><span class="option">keyid</span></samp>, a
-number specified in the <samp><span class="option">keyfile</span></samp> as this key's identifier.
-See the <samp><span class="option">keyfile</span></samp> option (<samp><span class="option">-k</span></samp>) for more details.
-<div class="node">
+<a name="authentication-option-_0028_002da_0029"></a>
+<h4 class="subsection">1.1.4 authentication option (-a)</h4>
+<a name="index-sntp_002dauthentication"></a>
+
+<p>This is the “enable authentication with the key <var>auth-keynumber</var>” option.
+This option takes a number argument <samp>auth-keynumber</samp>.
+Enable authentication using the key specified in this option’s
+argument. The argument of this option is the <samp>keyid</samp>, a
+number specified in the <samp>keyfile</samp> as this key’s identifier.
+See the <samp>keyfile</samp> option (<samp>-k</samp>) for more details.
+</p><hr>
<a name="sntp-broadcast"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#sntp-concurrent" accesskey="n" rel="next">sntp concurrent</a>, Previous: <a href="#sntp-authentication" accesskey="p" rel="prev">sntp authentication</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
</div>
-
-<h4 class="subsection">broadcast option (-b)</h4>
-
-<p><a name="index-sntp_002dbroadcast-7"></a>
-This is the “listen to the address specified for broadcast time sync” option.
-This option takes a string argument <samp><span class="file">broadcast-address</span></samp>.
-
-<p class="noindent">This option has some usage constraints. It:
-<li>may appear an unlimited number of times.
-</ul>
-
-
<p>If specified <code>sntp</code> will listen to the specified address
+<a name="broadcast-option-_0028_002db_0029"></a>
+<h4 class="subsection">1.1.5 broadcast option (-b)</h4>
+<a name="index-sntp_002dbroadcast"></a>
+
+<p>This is the “listen to the address specified for broadcast time sync” option.
+This option takes a string argument <samp>broadcast-address</samp>.
+</p>
+<p>This option has some usage constraints. It:
+<li> may appear an unlimited number of times.
+</li></ul>
+
+<p>If specified <code>sntp</code> will listen to the specified address
for NTP broadcasts. The default maximum wait time
-can (and probably should) be modified with <samp><span class="option">-t</span></samp>.
-<div class="node">
+can (and probably should) be modified with <samp>-t</samp>.
+</p><hr>
<a name="sntp-concurrent"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#sntp-gap" accesskey="n" rel="next">sntp gap</a>, Previous: <a href="#sntp-broadcast" accesskey="p" rel="prev">sntp broadcast</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
</div>
-
-<h4 class="subsection">concurrent option (-c)</h4>
-
-<p><a name="index-sntp_002dconcurrent-8"></a>
-This is the “concurrently query all ips returned for host-name” option.
-This option takes a string argument <samp><span class="file">host-name</span></samp>.
-
-<p class="noindent">This option has some usage constraints. It:
-<li>may appear an unlimited number of times.
-</ul>
-
- <p>Requests from an NTP "client" to a "server" should never be sent
+<a name="concurrent-option-_0028_002dc_0029"></a>
+<h4 class="subsection">1.1.6 concurrent option (-c)</h4>
+<a name="index-sntp_002dconcurrent"></a>
+
+<p>This is the “concurrently query all ips returned for host-name” option.
+This option takes a string argument <samp>host-name</samp>.
+</p>
+<p>This option has some usage constraints. It:
+<li> may appear an unlimited number of times.
+</li></ul>
+
+<p>Requests from an NTP "client" to a "server" should never be sent
more rapidly than one every 2 seconds. By default, any IPs returned
as part of a DNS lookup are assumed to be for a single instance of
<code>ntpd</code>, and therefore <code>sntp</code> will send queries to these IPs
one after another, with a 2-second gap in between each query.
-
- <p>The <samp><span class="option">-c</span></samp> or <samp><span class="option">--concurrent</span></samp> flag says that any IPs
+</p>
+<p>The <samp>-c</samp> or <samp>--concurrent</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">
+different machines, so we can send concurrent queries.
+</p><hr>
<a name="sntp-gap"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#sntp-kod" accesskey="n" rel="next">sntp kod</a>, Previous: <a href="#sntp-concurrent" accesskey="p" rel="prev">sntp concurrent</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
</div>
+<a name="gap-option-_0028_002dg_0029"></a>
+<h4 class="subsection">1.1.7 gap option (-g)</h4>
+<a name="index-sntp_002dgap"></a>
-<h4 class="subsection">gap option (-g)</h4>
-
-<p><a name="index-sntp_002dgap-9"></a>
-This is the “the gap (in milliseconds) between time requests” option.
-This option takes a number argument <samp><span class="file">milliseconds</span></samp>.
-Since we're only going to use the first valid response we get and
+<p>This is the “the gap (in milliseconds) between time requests” option.
+This option takes a number argument <samp>milliseconds</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">
+milliseconds.
+</p><hr>
<a name="sntp-kod"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#sntp-keyfile" accesskey="n" rel="next">sntp keyfile</a>, Previous: <a href="#sntp-gap" accesskey="p" rel="prev">sntp gap</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
</div>
+<a name="kod-option-_0028_002dK_0029"></a>
+<h4 class="subsection">1.1.8 kod option (-K)</h4>
+<a name="index-sntp_002dkod"></a>
-<h4 class="subsection">kod option (-K)</h4>
-
-<p><a name="index-sntp_002dkod-10"></a>
-This is the “kod history filename” option.
-This option takes a file argument <samp><span class="file">file-name</span></samp>.
+<p>This is the “kod history filename” option.
+This option takes a file argument <samp>file-name</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">
+warning message will be displayed. The file will not be created.
+</p><hr>
<a name="sntp-keyfile"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#sntp-logfile" accesskey="n" rel="next">sntp logfile</a>, Previous: <a href="#sntp-kod" accesskey="p" rel="prev">sntp kod</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
</div>
-
-<h4 class="subsection">keyfile option (-k)</h4>
-
-<p><a name="index-sntp_002dkeyfile-11"></a>
-This is the “look in this file for the key specified with <samp><span class="option">-a</span></samp>” option.
-This option takes a file argument <samp><span class="file">file-name</span></samp>.
-This option specifies the keyfile.
-<code>sntp</code> will search for the key specified with <samp><span class="option">-a</span></samp>
-<samp><span class="file">keyno</span></samp> in this file. See <samp><span class="command">ntp.keys(5)</span></samp> for more
-information.
-<div class="node">
+<a name="keyfile-option-_0028_002dk_0029"></a>
+<h4 class="subsection">1.1.9 keyfile option (-k)</h4>
+<a name="index-sntp_002dkeyfile"></a>
+
+<p>This is the “look in this file for the key specified with <samp>-a</samp>” option.
+This option takes a file argument <samp>file-name</samp>.
+This option specifies the keyfile.
+<code>sntp</code> will search for the key specified with <samp>-a</samp>
+<samp>keyno</samp> in this file. See <code>ntp.keys(5)</code> for more
+information.
+</p><hr>
<a name="sntp-logfile"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#sntp-steplimit" accesskey="n" rel="next">sntp steplimit</a>, Previous: <a href="#sntp-keyfile" accesskey="p" rel="prev">sntp keyfile</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
</div>
+<a name="logfile-option-_0028_002dl_0029"></a>
+<h4 class="subsection">1.1.10 logfile option (-l)</h4>
+<a name="index-sntp_002dlogfile"></a>
-<h4 class="subsection">logfile option (-l)</h4>
-
-<p><a name="index-sntp_002dlogfile-12"></a>
-This is the “log to specified logfile” option.
-This option takes a file argument <samp><span class="file">file-name</span></samp>.
+<p>This is the “log to specified logfile” option.
+This option takes a file argument <samp>file-name</samp>.
This option causes the client to write log messages to the specified
-<samp><span class="file">logfile</span></samp>.
-<div class="node">
+<samp>logfile</samp>.
+</p><hr>
<a name="sntp-steplimit"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#sntp-ntpversion" accesskey="n" rel="next">sntp ntpversion</a>, Previous: <a href="#sntp-logfile" accesskey="p" rel="prev">sntp logfile</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
</div>
-
-<h4 class="subsection">steplimit option (-M)</h4>
-
-<p><a name="index-sntp_002dsteplimit-13"></a>
-This is the “adjustments less than <var>steplimit</var> msec will be slewed” option.
-This option takes a number argument.
-If the time adjustment is less than <samp><span class="file">steplimit</span></samp> milliseconds,
-slew the amount using <samp><span class="command">adjtime(2)</span></samp>. Otherwise, step the
-correction using <samp><span class="command">settimeofday(2)</span></samp>. The default value is 0,
+<a name="steplimit-option-_0028_002dM_0029"></a>
+<h4 class="subsection">1.1.11 steplimit option (-M)</h4>
+<a name="index-sntp_002dsteplimit"></a>
+
+<p>This is the “adjustments less than <var>steplimit</var> msec will be slewed” option.
+This option takes a number argument.
+If the time adjustment is less than <samp>steplimit</samp> milliseconds,
+slew the amount using <code>adjtime(2)</code>. Otherwise, step the
+correction using <code>settimeofday(2)</code>. 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">
+different situations demand different values.
+</p><hr>
<a name="sntp-ntpversion"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#sntp-usereservedport" accesskey="n" rel="next">sntp usereservedport</a>, Previous: <a href="#sntp-steplimit" accesskey="p" rel="prev">sntp steplimit</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
</div>
+<a name="ntpversion-option-_0028_002do_0029"></a>
+<h4 class="subsection">1.1.12 ntpversion option (-o)</h4>
+<a name="index-sntp_002dntpversion"></a>
-<h4 class="subsection">ntpversion option (-o)</h4>
-
-<p><a name="index-sntp_002dntpversion-14"></a>
-This is the “send <var>int</var> as our ntp protocol version” option.
-This option takes a number argument.
+<p>This is the “send <var>int</var> as our ntp protocol version” option.
+This option takes a number argument.
When sending requests to a remote server, tell them we are running
-NTP protocol version <samp><span class="file">ntpversion</span></samp> .
-<div class="node">
+NTP protocol version <samp>ntpversion</samp> .
+</p><hr>
<a name="sntp-usereservedport"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#sntp-timeout" accesskey="n" rel="next">sntp timeout</a>, Previous: <a href="#sntp-ntpversion" accesskey="p" rel="prev">sntp ntpversion</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
</div>
+<a name="usereservedport-option-_0028_002dr_0029"></a>
+<h4 class="subsection">1.1.13 usereservedport option (-r)</h4>
+<a name="index-sntp_002dusereservedport"></a>
-<h4 class="subsection">usereservedport option (-r)</h4>
-
-<p><a name="index-sntp_002dusereservedport-15"></a>
-This is the “use the ntp reserved port (port 123)” option.
+<p>This is the “use the ntp reserved port (port 123)” option.
Use port 123, which is reserved for NTP, for our network
-communications.
-<div class="node">
+communications.
+</p><hr>
<a name="sntp-timeout"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#sntp-wait" accesskey="n" rel="next">sntp wait</a>, Previous: <a href="#sntp-usereservedport" accesskey="p" rel="prev">sntp usereservedport</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
</div>
+<a name="timeout-option-_0028_002dt_0029"></a>
+<h4 class="subsection">1.1.14 timeout option (-t)</h4>
+<a name="index-sntp_002dtimeout"></a>
-<h4 class="subsection">timeout option (-t)</h4>
-
-<p><a name="index-sntp_002dtimeout-16"></a>
-This is the “the number of seconds to wait for responses” option.
-This option takes a number argument <samp><span class="file">seconds</span></samp>.
+<p>This is the “the number of seconds to wait for responses” option.
+This option takes a number argument <samp>seconds</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">
+likely needed.
+</p><hr>
<a name="sntp-wait"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#sntp-config" accesskey="n" rel="next">sntp config</a>, Previous: <a href="#sntp-timeout" accesskey="p" rel="prev">sntp timeout</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
</div>
-
-<h4 class="subsection">wait option</h4>
-
-<p><a name="index-sntp_002dwait-17"></a>
-This is the “wait for pending replies (if not setting the time)” option.
-
-<p class="noindent">This option has some usage constraints. It:
- <ul>
-<li>can be disabled with –no-wait.
-<li>It is enabled by default.
-</ul>
-
- <p>If we are not setting the time, wait for all pending responses.
-
-<div class="node">
+<a name="wait-option"></a>
+<h4 class="subsection">1.1.15 wait option</h4>
+<a name="index-sntp_002dwait"></a>
+
+<p>This is the “wait for pending replies (if not setting the time)” option.
+</p>
+<p>This option has some usage constraints. It:
+</p><ul>
+<li> can be disabled with –no-wait.
+</li><li> It is enabled by default.
+</li></ul>
+
+<p>If we are not setting the time, wait for all pending responses.
+</p>
+
+<hr>
<a name="sntp-config"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#sntp-exit-status" accesskey="n" rel="next">sntp exit status</a>, Previous: <a href="#sntp-wait" accesskey="p" rel="prev">sntp wait</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
</div>
-
-<h4 class="subsection">presetting/configuring sntp</h4>
+<a name="presetting_002fconfiguring-sntp"></a>
+<h4 class="subsection">1.1.16 presetting/configuring sntp</h4>
<p>Any option that is not marked as <i>not presettable</i> may be preset by
-loading values from configuration ("rc" or "ini") files, and values from environment variables named <code>SNTP</code> and <code>SNTP_<OPTION_NAME></code>. <code><OPTION_NAME></code> must be one of
-the options listed above in upper case and segmented with underscores.
+loading values from configuration ("rc" or "ini") files, and values from environment variables named <code>SNTP</code> and <code>SNTP_<OPTION_NAME></code>. <code><OPTION_NAME></code> must be one of
+the options listed above in upper case and segmented with underscores.
The <code>SNTP</code> variable will be tokenized and parsed like
the command line. The remaining variables are tested for existence and their
values are treated like option arguments.
-
-<p class="noindent"><code>libopts</code> will search in 2 places for configuration files:
- <ul>
-<li>$HOME
-<li>$PWD
-</ul>
- The environment variables <code>HOME</code>, and <code>PWD</code>
-are expanded and replaced when <samp><span class="file">sntp</span></samp> runs.
-For any of these that are plain files, they are simply processed.
-For any that are directories, then a file named <samp><span class="file">.ntprc</span></samp> is searched for
+</p>
+
+<p><code>libopts</code> will search in 2 places for configuration files:
+</p><ul>
+<li> $HOME
+</li><li> $PWD
+</li></ul>
+<p>The environment variables <code>HOME</code>, and <code>PWD</code>
+are expanded and replaced when <samp>sntp</samp> runs.
+For any of these that are plain files, they are simply processed.
+For any that are directories, then a file named <samp>.ntprc</samp> is searched for
within that directory and processed.
-
- <p>Configuration files may be in a wide variety of formats.
+</p>
+<p>Configuration files may be in a wide variety of formats.
The basic format is an option name followed by a value (argument) on the
same line. Values may be separated from the option name with a colon,
equal sign or simply white space. Values may be continued across multiple
lines by escaping the newline with a backslash.
-
- <p>Multiple programs may also share the same initialization file.
+</p>
+<p>Multiple programs may also share the same initialization file.
Common options are collected at the top, followed by program specific
segments. The segments are separated by lines like:
-<pre class="example"> [SNTP]
-</pre>
- <p class="noindent">or by
-<pre class="example"> <?program sntp>
-</pre>
- <p class="noindent">Do not mix these styles within one configuration file.
-
- <p>Compound values and carefully constructed string values may also be
+</p><div class="example">
+<pre class="example">[SNTP]
+</pre></div>
+<p>or by
+</p><div class="example">
+<pre class="example"><?program sntp>
+</pre></div>
+<p>Do not mix these styles within one configuration file.
+</p>
+<p>Compound values and carefully constructed string values may also be
specified using XML syntax:
-<pre class="example"> <option-name>
- <sub-opt>...&lt;...&gt;...</sub-opt>
- </option-name>
-</pre>
- <p class="noindent">yielding an <code>option-name.sub-opt</code> string value of
-<pre class="example"> "...<...>..."
-</pre>
- <p><code>AutoOpts</code> does not track suboptions. You simply note that it is a
+</p><div class="example">
+<pre class="example"><option-name>
+ <sub-opt>...&lt;...&gt;...</sub-opt>
+</option-name>
+</pre></div>
+<p>yielding an <code>option-name.sub-opt</code> string value of
+</p><div class="example">
+<pre class="example">"...<...>..."
+</pre></div>
+<p><code>AutoOpts</code> does not track suboptions. You simply note that it is a
hierarchicly valued option. <code>AutoOpts</code> does provide a means for searching
the associated name/value pair list (see: optionFindValue).
-
- <p>The command line options relating to configuration and/or usage help are:
-
-<h5 class="subsubheading">version (-)</h5>
+</p>
+<p>The command line options relating to configuration and/or usage help are:
+</p>
+<a name="version-_0028_002d_0029"></a>
+<h4 class="subsubheading">version (-)</h4>
<p>Print the program version to standard out, optionally with licensing
information, then exit 0. The optional argument specifies how much licensing
-detail to provide. The default is to print just the version. The licensing infomation may be selected with an option argument.
+detail to provide. The default is to print just the version. The licensing infomation may be selected with an option argument.
Only the first letter of the argument is examined:
-
- <dl>
-<dt>‘<samp><span class="samp">version</span></samp>’<dd>Only print the version. This is the default.
-<br><dt>‘<samp><span class="samp">copyright</span></samp>’<dd>Name the copyright usage licensing terms.
-<br><dt>‘<samp><span class="samp">verbose</span></samp>’<dd>Print the full copyright usage licensing terms.
+</p>
+<dl compact="compact">
+<dt>‘<samp>version</samp>’</dt>
+<dd><p>Only print the version. This is the default.
+</p></dd>
+<dt>‘<samp>copyright</samp>’</dt>
+<dd><p>Name the copyright usage licensing terms.
+</p></dd>
+<dt>‘<samp>verbose</samp>’</dt>
+<dd><p>Print the full copyright usage licensing terms.
+</p></dd>
</dl>
-<div class="node">
+<hr>
<a name="sntp-exit-status"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#sntp-Usage" accesskey="n" rel="next">sntp Usage</a>, Previous: <a href="#sntp-config" accesskey="p" rel="prev">sntp config</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
</div>
-
-<h4 class="subsection">sntp exit status</h4>
+<a name="sntp-exit-status-1"></a>
+<h4 class="subsection">1.1.17 sntp exit status</h4>
<p>One of the following exit values will be returned:
- <dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
-<br><dt>‘<samp><span class="samp">66 (EX_NOINPUT)</span></samp>’<dd>A specified configuration file could not be loaded.
-<br><dt>‘<samp><span class="samp">70 (EX_SOFTWARE)</span></samp>’<dd>libopts had an internal operational error. Please report
-it to autogen-users@lists.sourceforge.net. Thank you.
+</p><dl compact="compact">
+<dt>‘<samp>0 (EXIT_SUCCESS)</samp>’</dt>
+<dd><p>Successful program execution.
+</p></dd>
+<dt>‘<samp>1 (EXIT_FAILURE)</samp>’</dt>
+<dd><p>The operation failed or the command syntax was not valid.
+</p></dd>
+<dt>‘<samp>66 (EX_NOINPUT)</samp>’</dt>
+<dd><p>A specified configuration file could not be loaded.
+</p></dd>
+<dt>‘<samp>70 (EX_SOFTWARE)</samp>’</dt>
+<dd><p>libopts had an internal operational error. Please report
+it to autogen-users@lists.sourceforge.net. Thank you.
+</p></dd>
</dl>
- <div class="node">
+<hr>
<a name="sntp-Usage"></a>
-<p><hr>
-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>
-
+<div class="header">
+<p>
+Next: <a href="#sntp-Authors" accesskey="n" rel="next">sntp Authors</a>, Previous: <a href="#sntp-exit-status" accesskey="p" rel="prev">sntp exit status</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
</div>
-
-<h4 class="subsection">sntp Usage</h4>
-
-<div class="node">
+<a name="sntp-Usage-1"></a>
+<h4 class="subsection">1.1.18 sntp Usage</h4>
+<hr>
<a name="sntp-Authors"></a>
-<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#sntp-Usage">sntp Usage</a>,
-Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-
+<div class="header">
+<p>
+Previous: <a href="#sntp-Usage" accesskey="p" rel="prev">sntp Usage</a>, Up: <a href="#sntp-Invocation" accesskey="u" rel="up">sntp Invocation</a> </p>
</div>
+<a name="sntp-Authors-1"></a>
+<h4 class="subsection">1.1.19 sntp Authors</h4>
-<h4 class="subsection">sntp Authors</h4>
-
-<div class="node">
+<hr>
<a name="Usage"></a>
-<p><hr>
-
-
+<div class="header">
+<p>
+Previous: <a href="#sntp-Invocation" accesskey="p" rel="prev">sntp Invocation</a>, Up: <a href="#sntp-Description" accesskey="u" rel="up">sntp Description</a> </p>
</div>
-
-<!-- node-name, next, previous, up -->
-<h3 class="section">Usage</h3>
+<a name="Usage-1"></a>
+<h3 class="section">1.2 Usage</h3>
<p>The simplest use of this program is as an unprivileged command to
-check the current time, offset, and error in the local clock.
+check the current time, offset, and error in the local clock.
For example:
+</p>
+<div class="example">
+<pre class="example">sntp ntpserver.somewhere
+</pre></div>
-<pre class="example"> sntp ntpserver.somewhere
-</pre>
- <p>With suitable privilege, it can be run as a command or in a
+<p>With suitable privilege, it can be run as a command or in a
<code>crom</code> job to reset the local clock from a reliable server, like
-the <code>ntpdate</code> and <code>rdate</code> commands.
+the <code>ntpdate</code> and <code>rdate</code> commands.
For example:
+</p>
+<div class="example">
+<pre class="example">sntp -a ntpserver.somewhere
+</pre></div>
+<hr>
+
-<pre class="example"> sntp -a ntpserver.somewhere
-</pre>
- </body></html>
+</body>
+</html>
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH sntp @SNTP_MS@ "04 Feb 2020" "4.2.8p13" "User Commands"
+.TH sntp @SNTP_MS@ "03 Mar 2020" "4.2.8p13" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:45 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:53 PM by AutoGen 5.18.5
.\" From the definitions sntp-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt SNTP @SNTP_MS@ User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (sntp-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:52:42 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:34:50 PM by AutoGen 5.18.5
.\" From the definitions sntp-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-ntp-keygen.texi)
#
-# It has been AutoGen-ed February 4, 2020 at 11:53:42 PM by AutoGen 5.18.5
+# It has been AutoGen-ed March 3, 2020 at 04:36:21 PM by AutoGen 5.18.5
# From the definitions ntp-keygen-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
/*
* EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.c)
*
- * It has been AutoGen-ed February 4, 2020 at 11:53:36 PM by AutoGen 5.18.5
+ * It has been AutoGen-ed March 3, 2020 at 04:36:17 PM by AutoGen 5.18.5
* From the definitions ntp-keygen-opts.def
* and the template file options
*
- * Generated from AutoOpts 41:0:16 templates.
+ * Generated from AutoOpts 41:1:16 templates.
*
* AutoOpts is a copyrighted work. This source file is not encumbered
* by AutoOpts licensing, but is provided under the licensing terms chosen
/*
* EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.h)
*
- * It has been AutoGen-ed February 4, 2020 at 11:53:36 PM by AutoGen 5.18.5
+ * It has been AutoGen-ed March 3, 2020 at 04:36:17 PM by AutoGen 5.18.5
* From the definitions ntp-keygen-opts.def
* and the template file options
*
- * Generated from AutoOpts 41:0:16 templates.
+ * Generated from AutoOpts 41:1:16 templates.
*
* AutoOpts is a copyrighted work. This header file is not encumbered
* by AutoOpts licensing, but is provided under the licensing terms chosen
* tolerable version is at least as old as what was current when the header
* template was released.
*/
-#define AO_TEMPLATE_VERSION 167936
+#define AO_TEMPLATE_VERSION 167937
#if (AO_TEMPLATE_VERSION < OPTIONS_MINIMUM_VERSION) \
|| (AO_TEMPLATE_VERSION > OPTIONS_STRUCT_VERSION)
# error option template version mismatches autoopts/options.h header
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntp-keygen 1ntp-keygenman "04 Feb 2020" "ntp (4.2.8p13)" "User Commands"
+.TH ntp-keygen 1ntp-keygenman "03 Mar 2020" "ntp (4.2.8p13)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:43 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:36:22 PM by AutoGen 5.18.5
.\" From the definitions ntp-keygen-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt NTP_KEYGEN 1ntp-keygenmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:40 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:36:19 PM by AutoGen 5.18.5
.\" From the definitions ntp-keygen-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
with a status code of 0.
</p>
<div class="example">
-<pre class="example">ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.8p13
+<pre class="example">ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.8p13-foo
Usage: ntp-keygen [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
Flg Arg Option-Name Description
-b Num imbits identity modulus bits
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntp-keygen @NTP_KEYGEN_MS@ "04 Feb 2020" "ntp (4.2.8p13)" "User Commands"
+.TH ntp-keygen @NTP_KEYGEN_MS@ "03 Mar 2020" "ntp (4.2.8p13)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:43 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:36:22 PM by AutoGen 5.18.5
.\" From the definitions ntp-keygen-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 4 2020
+.Dd March 3 2020
.Dt NTP_KEYGEN @NTP_KEYGEN_MS@ User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 4, 2020 at 11:53:40 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed March 3, 2020 at 04:36:19 PM by AutoGen 5.18.5
.\" From the definitions ntp-keygen-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
projects / thirdparty / ntp.git / commitdiff
