From: NTP Release Engineering Date: Wed, 4 Mar 2020 00:49:54 +0000 (-0800) Subject: NTP_4_2_8P13 X-Git-Tag: NTP_4_2_8P13^0 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=aac85367b8a3da6633e3b265cdd1a9f51e92bdc2;p=thirdparty%2Fntp.git NTP_4_2_8P13 bk: 5e5efb32F1r0twdwILvds6U-FbRDaw --- diff --git a/ChangeLog b/ChangeLog index 1c5777d9b..a57a58cb9 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,4 +1,5 @@ --- +(4.2.8p13) 2020/03/03 Released by Harlan Stenn * [Sec 3610] process_control() should bail earlier on short packets. stenn@ - Reported by Philippe Antoine diff --git a/ntpd/invoke-ntp.conf.texi b/ntpd/invoke-ntp.conf.texi index 1a5023286..fa806db39 100644 --- a/ntpd/invoke-ntp.conf.texi +++ b/ntpd/invoke-ntp.conf.texi @@ -6,7 +6,7 @@ # # 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 @@ -134,8 +134,8 @@ qualifier forces DNS resolution to the IPv6 namespace. 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}]} @@ -305,9 +305,6 @@ Marks the server as unused, except for display purposes. 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, @@ -321,7 +318,8 @@ provided in @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. @@ -349,6 +347,13 @@ Valid in 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 @@ -1622,6 +1627,10 @@ The @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 @@ -2766,6 +2775,21 @@ For the JJY driver (type 40 mode 100 - 180), the argument is 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} diff --git a/ntpd/invoke-ntp.keys.texi b/ntpd/invoke-ntp.keys.texi index 18785b4b1..88c0b79cb 100644 --- a/ntpd/invoke-ntp.keys.texi +++ b/ntpd/invoke-ntp.keys.texi @@ -6,7 +6,7 @@ # # 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 diff --git a/ntpd/invoke-ntpd.texi b/ntpd/invoke-ntpd.texi index 183802fec..76ed0d761 100644 --- a/ntpd/invoke-ntpd.texi +++ b/ntpd/invoke-ntpd.texi @@ -6,7 +6,7 @@ # # 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 @@ -164,7 +164,7 @@ Usage: ntpd [ - [] | --[@{=| @}] ]... \ -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 @@ -187,7 +187,7 @@ Usage: ntpd [ - [] | --[@{=| @}] ]... \ -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 diff --git a/ntpd/ntp.conf.5man b/ntpd/ntp.conf.5man index 401cf0785..890cd4319 100644 --- a/ntpd/ntp.conf.5man +++ b/ntpd/ntp.conf.5man @@ -10,11 +10,11 @@ .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 @@ -161,9 +161,9 @@ qualifier forces DNS resolution to the IPv6 namespace. 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 @@ -352,10 +352,6 @@ The server is discarded by the selection algroithm. .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, @@ -370,7 +366,8 @@ provided in 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. @@ -401,6 +398,13 @@ Valid in 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 @@ -1838,6 +1842,11 @@ The 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 @@ -3092,6 +3101,22 @@ 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. .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[] diff --git a/ntpd/ntp.conf.5mdoc b/ntpd/ntp.conf.5mdoc index fbe2d7ed1..f6668d526 100644 --- a/ntpd/ntp.conf.5mdoc +++ b/ntpd/ntp.conf.5mdoc @@ -1,9 +1,9 @@ -.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 @@ -144,6 +144,7 @@ equivalent classes for that address family. .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 @@ -154,6 +155,7 @@ equivalent classes for that address family. .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 @@ -346,9 +348,6 @@ Marks the server as unused, except for display purposes. 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, @@ -362,7 +361,8 @@ provided in .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. @@ -390,6 +390,12 @@ Valid in 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 @@ -1694,6 +1700,10 @@ The .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 @@ -2919,6 +2929,31 @@ For the JJY driver (type 40 mode 100 \- 180), the argument is 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 diff --git a/ntpd/ntp.conf.html b/ntpd/ntp.conf.html index e19e32642..3f4f065c9 100644 --- a/ntpd/ntp.conf.html +++ b/ntpd/ntp.conf.html @@ -257,8 +257,8 @@ qualifier forces DNS resolution to the IPv6 namespace. See IPv6 references for the equivalent classes for that address family.

-
pool address [burst] [iburst] [version version] [prefer] [minpoll minpoll] [maxpoll maxpoll]
-
server address [key key | autokey] [burst] [iburst] [version version] [prefer] [minpoll minpoll] [maxpoll maxpoll] [true]
+
pool address [burst] [iburst] [version version] [prefer] [minpoll minpoll] [maxpoll maxpoll] [xmtnonce]
+
server address [key key | autokey] [burst] [iburst] [version version] [prefer] [minpoll minpoll] [maxpoll maxpoll] [true] [xmtnonce]
peer address [key key | autokey] [version version] [prefer] [minpoll minpoll] [maxpoll maxpoll] [true] [xleave]
broadcast address [key key | autokey] [version version] [prefer] [minpoll minpoll] [ttl ttl] [xleave]
manycastclient address [key key | autokey] [version version] [prefer] [minpoll minpoll] [maxpoll maxpoll] [ttl ttl]
@@ -440,10 +440,6 @@ The server is discarded by the selection algroithm.
preempt

Says the association can be preempted.

-
true
-

Marks the server as a truechimer. -Use this option only for testing. -

prefer

Marks the server as preferred. All other things being equal, @@ -458,7 +454,8 @@ provided in for further information.

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 only be used while testing an association. @@ -490,6 +487,14 @@ and broadcast modes only, this flag enables interleave mode.

+
xmtnonce
+

Valid only for +server +and +pool +modes, this flag puts a random number in the packet’s transmit timestamp. +

+

1.1.1.2 Auxiliary Commands

@@ -1862,6 +1867,11 @@ The is considered more specific and is sorted later in the list.

+
serverresponse fuzz
+

When reponding to server requests, +fuzz the low order bits of the +reftime. +

version

Deny packets that do not match the current NTP version.

@@ -3077,6 +3087,22 @@ 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.

+
pollskewlist [poll value | value] ... [default value | value]
+

Enable skewing of our poll requests to our servers. +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. +

reset [allpeers] [auth] [ctl] [io] [mem] [sys] [timer]

Reset one or more groups of counters maintained by ntpd diff --git a/ntpd/ntp.conf.man.in b/ntpd/ntp.conf.man.in index f1a942ab1..a27ac6faf 100644 --- a/ntpd/ntp.conf.man.in +++ b/ntpd/ntp.conf.man.in @@ -10,11 +10,11 @@ .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 @@ -161,9 +161,9 @@ qualifier forces DNS resolution to the IPv6 namespace. 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 @@ -352,10 +352,6 @@ The server is discarded by the selection algroithm. .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, @@ -370,7 +366,8 @@ provided in 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. @@ -401,6 +398,13 @@ Valid in 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 @@ -1838,6 +1842,11 @@ The 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 @@ -3092,6 +3101,22 @@ 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. .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[] diff --git a/ntpd/ntp.conf.mdoc.in b/ntpd/ntp.conf.mdoc.in index 82b549d93..d72143791 100644 --- a/ntpd/ntp.conf.mdoc.in +++ b/ntpd/ntp.conf.mdoc.in @@ -1,9 +1,9 @@ -.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 @@ -144,6 +144,7 @@ equivalent classes for that address family. .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 @@ -154,6 +155,7 @@ equivalent classes for that address family. .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 @@ -346,9 +348,6 @@ Marks the server as unused, except for display purposes. 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, @@ -362,7 +361,8 @@ provided in .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. @@ -390,6 +390,12 @@ Valid in 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 @@ -1694,6 +1700,10 @@ The .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 @@ -2919,6 +2929,31 @@ For the JJY driver (type 40 mode 100 \- 180), the argument is 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 diff --git a/ntpd/ntp.keys.5man b/ntpd/ntp.keys.5man index 1e993edfd..d5e54dd2a 100644 --- a/ntpd/ntp.keys.5man +++ b/ntpd/ntp.keys.5man @@ -1,8 +1,8 @@ -.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 diff --git a/ntpd/ntp.keys.5mdoc b/ntpd/ntp.keys.5mdoc index 2d445e29e..da566d281 100644 --- a/ntpd/ntp.keys.5mdoc +++ b/ntpd/ntp.keys.5mdoc @@ -1,9 +1,9 @@ -.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 diff --git a/ntpd/ntp.keys.man.in b/ntpd/ntp.keys.man.in index 85cbf2019..ec317ff8c 100644 --- a/ntpd/ntp.keys.man.in +++ b/ntpd/ntp.keys.man.in @@ -1,8 +1,8 @@ -.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 diff --git a/ntpd/ntp.keys.mdoc.in b/ntpd/ntp.keys.mdoc.in index 0358abace..baf59e3af 100644 --- a/ntpd/ntp.keys.mdoc.in +++ b/ntpd/ntp.keys.mdoc.in @@ -1,9 +1,9 @@ -.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 diff --git a/ntpd/ntpd-opts.c b/ntpd/ntpd-opts.c index 586d8ad76..893f32ae3 100644 --- a/ntpd/ntpd-opts.c +++ b/ntpd/ntpd-opts.c @@ -1,11 +1,11 @@ /* * 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 diff --git a/ntpd/ntpd-opts.h b/ntpd/ntpd-opts.h index 3a4e9bd8f..0bde988db 100644 --- a/ntpd/ntpd-opts.h +++ b/ntpd/ntpd-opts.h @@ -1,11 +1,11 @@ /* * 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 @@ -53,7 +53,7 @@ * 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 diff --git a/ntpd/ntpd.1ntpdman b/ntpd/ntpd.1ntpdman index 8a69e17a4..40b0a425e 100644 --- a/ntpd/ntpd.1ntpdman +++ b/ntpd/ntpd.1ntpdman @@ -10,11 +10,11 @@ .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 diff --git a/ntpd/ntpd.1ntpdmdoc b/ntpd/ntpd.1ntpdmdoc index eb8140a80..73adb7475 100644 --- a/ntpd/ntpd.1ntpdmdoc +++ b/ntpd/ntpd.1ntpdmdoc @@ -1,9 +1,9 @@ -.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 diff --git a/ntpd/ntpd.man.in b/ntpd/ntpd.man.in index a11b4f964..4e6345d56 100644 --- a/ntpd/ntpd.man.in +++ b/ntpd/ntpd.man.in @@ -10,11 +10,11 @@ .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 diff --git a/ntpd/ntpd.mdoc.in b/ntpd/ntpd.mdoc.in index a6a4b0475..1ebedbe6c 100644 --- a/ntpd/ntpd.mdoc.in +++ b/ntpd/ntpd.mdoc.in @@ -1,9 +1,9 @@ -.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 diff --git a/ntpdc/invoke-ntpdc.texi b/ntpdc/invoke-ntpdc.texi index 750fd67f9..4a94e5ea7 100644 --- a/ntpdc/invoke-ntpdc.texi +++ b/ntpdc/invoke-ntpdc.texi @@ -6,7 +6,7 @@ # # 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 diff --git a/ntpdc/ntpdc-opts.c b/ntpdc/ntpdc-opts.c index f61fcc1ec..41ff7eaab 100644 --- a/ntpdc/ntpdc-opts.c +++ b/ntpdc/ntpdc-opts.c @@ -1,11 +1,11 @@ /* * 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 diff --git a/ntpdc/ntpdc-opts.h b/ntpdc/ntpdc-opts.h index 6c8401622..7be6d410f 100644 --- a/ntpdc/ntpdc-opts.h +++ b/ntpdc/ntpdc-opts.h @@ -1,11 +1,11 @@ /* * 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 @@ -53,7 +53,7 @@ * 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 diff --git a/ntpdc/ntpdc.1ntpdcman b/ntpdc/ntpdc.1ntpdcman index 0977d4164..f19f12a44 100644 --- a/ntpdc/ntpdc.1ntpdcman +++ b/ntpdc/ntpdc.1ntpdcman @@ -10,11 +10,11 @@ .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 diff --git a/ntpdc/ntpdc.1ntpdcmdoc b/ntpdc/ntpdc.1ntpdcmdoc index ba8655c7b..f48979e0b 100644 --- a/ntpdc/ntpdc.1ntpdcmdoc +++ b/ntpdc/ntpdc.1ntpdcmdoc @@ -1,9 +1,9 @@ -.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 diff --git a/ntpdc/ntpdc.html b/ntpdc/ntpdc.html index 438777564..0d550eb7f 100644 --- a/ntpdc/ntpdc.html +++ b/ntpdc/ntpdc.html @@ -1,162 +1,219 @@ - + + + -ntpdc: NTPD Control User's Manual - - - - - - - + +ntpdc: NTPD Control User’s Manual + + + + + + + + + + + - -

ntpdc: NTPD Control User's Manual

-
- -


-Next: , -Previous: (dir), -Up: (dir) -
+ +

ntpdc: NTPD Control User’s Manual

+ + + -

ntpdc: NTPD Control User Manual

-

This document describes the use of the NTP Project's ntpdc program, + +

+

+Next: , Previous: , Up: (dir)  

+
+ +

ntpdc: NTPD Control User Manual

+ +

This document describes the use of the NTP Project’s ntpdc 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. - -

This document applies to version 4.2.8p13 of ntpdc. - -

The program implements the SNTP protocol as defined by RFC 5905, the NTPv4 +

+

This document applies to version 4.2.8p13 of ntpdc. +

+

The program implements the SNTP protocol as defined by RFC 5905, the NTPv4 IETF specification. +

+ +

Short Table of Contents

-
-

Short Contents

-
    -ntpdc: NTPD Control User Manual + - - -
    - -


    + + + + + +
    + +
    +

    +Next: , Up: Top  

    - - -

    Description

    + +

    1 Description

    By default, ntpdc writes the local data and time (i.e., not UTC) to the standard output in the format: +

    +
    +
    1996-10-15 20:17:25.123 (+0800) +4.567 +/- 0.089 secs
    +
    -
         1996-10-15 20:17:25.123 (+0800) +4.567 +/- 0.089 secs
    -
    -

    where +

    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. - -

    +

    + + + + + +
    -


    - - +
    +

    +Next: , Previous: , Up: ntpdc Description  

    + +

    1.1 Invoking ntpdc

    + + -

    Invoking ntpdc

    -

    -

    ntpdc -is deprecated. +

    ntpdc +is deprecated. Please use ntpq(1ntpqmdoc) instead - it can do everything ntpdc used to do, and it does so using a much more sane interface. - -

    ntpdc +

    +

    ntpdc is a utility program used to query ntpd(1ntpdmdoc) 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 ntpdc -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 ntpdc - -

    This section was generated by AutoGen, -using the agtexi-cmd template and the option descriptions for the ntpdc program. +

    +

    This section was generated by AutoGen, +using the agtexi-cmd template and the option descriptions for the ntpdc program. This software is released under the NTP license, <http://ntp.org/license>. - -

    - -
    +

    + + + + + + + + + + + + + + + + + + +
    -


    -Next: , -Up: ntpdc Invocation - +
    +

    +Next: , Up: ntpdc Invocation  

    - -

    ntpdc help/usage (--help)

    - -

    -This is the automatically generated usage text for ntpdc. - -

    The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print -the usage text by passing it through a pager program. + +

    1.1.1 ntpdc help/usage (--help)

    + + +

    This is the automatically generated usage text for ntpdc. +

    +

    The text printed is the same whether selected with the help option +(--help) or the more-help option (--more-help). more-help will print +the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0. - +

    +
    ntpdc - vendor-specific NTPD control program - Ver. 4.2.8p13
     Usage:  ntpdc [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]
       Flg Arg Option-Name    Description
    @@ -201,335 +258,333 @@ The following option preset mechanisms are supported:
      - examining environment variables named NTPDC_*
     
     Please send bug reports to:  <http://bugs.ntp.org, bugs@ntp.org>
    -
    -
    - -


    -Next: , -Previous: ntpdc usage, -Up: ntpdc Invocation +
    +
    + +
    +

    +Next: , Previous: , Up: ntpdc Invocation  

    - -

    ipv4 option (-4)

    - -

    -This is the “force ipv4 dns name resolution” option. - -

    This option has some usage constraints. It: -

      -
    • must not appear in combination with any of the following options: -ipv6. -
    - -

    Force DNS resolution of following host names on the command line -to the IPv4 namespace. -

    + +

    1.1.2 ipv4 option (-4)

    + + +

    This is the “force ipv4 dns name resolution” option. +

    +

    This option has some usage constraints. It: +

      +
    • must not appear in combination with any of the following options: +ipv6. +
    + +

    Force DNS resolution of following host names on the command line +to the IPv4 namespace. +


    -


    -Next: , -Previous: ntpdc ipv4, -Up: ntpdc Invocation - +
    +

    +Next: , Previous: , Up: ntpdc Invocation  

    - -

    ipv6 option (-6)

    - -

    -This is the “force ipv6 dns name resolution” option. - -

    This option has some usage constraints. It: -

      -
    • must not appear in combination with any of the following options: -ipv4. -
    - -

    Force DNS resolution of following host names on the command line -to the IPv6 namespace. -

    + +

    1.1.3 ipv6 option (-6)

    + + +

    This is the “force ipv6 dns name resolution” option. +

    +

    This option has some usage constraints. It: +

      +
    • must not appear in combination with any of the following options: +ipv4. +
    + +

    Force DNS resolution of following host names on the command line +to the IPv6 namespace. +


    -


    -Next: , -Previous: ntpdc ipv6, -Up: ntpdc Invocation - +
    +

    +Next: , Previous: , Up: ntpdc Invocation  

    - -

    command option (-c)

    - -

    -This is the “run a command and exit” option. -This option takes a string argument cmd. - -

    This option has some usage constraints. It: -

      -
    • may appear an unlimited number of times. -
    - -

    The following argument is interpreted as an interactive format command + +

    1.1.4 command option (-c)

    + + +

    This is the “run a command and exit” option. +This option takes a string argument cmd. +

    +

    This option has some usage constraints. It: +

      +
    • may appear an unlimited number of times. +
    + +

    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). -

    +host(s). +


    -


    -Next: , -Previous: ntpdc command, -Up: ntpdc Invocation - +
    +

    +Next: , Previous: , Up: ntpdc Invocation  

    - -

    interactive option (-i)

    - -

    -This is the “force ntpq to operate in interactive mode” option. - -

    This option has some usage constraints. It: -

      -
    • must not appear in combination with any of the following options: -command, listpeers, peers, showpeers. -
    - -

    Force ntpq to operate in interactive mode. Prompts will be written -to the standard output and commands read from the standard input. -

    + +

    1.1.5 interactive option (-i)

    + + +

    This is the “force ntpq to operate in interactive mode” option. +

    +

    This option has some usage constraints. It: +

      +
    • must not appear in combination with any of the following options: +command, listpeers, peers, showpeers. +
    + +

    Force ntpq to operate in interactive mode. Prompts will be written +to the standard output and commands read from the standard input. +


    -


    -Next: , -Previous: ntpdc interactive, -Up: ntpdc Invocation - +
    +

    +Next: , Previous: , Up: ntpdc Invocation  

    - -

    listpeers option (-l)

    - -

    -This is the “print a list of the peers” option. - -

    This option has some usage constraints. It: -

      -
    • must not appear in combination with any of the following options: -command. -
    - -

    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. -

    + +

    1.1.6 listpeers option (-l)

    + + +

    This is the “print a list of the peers” option. +

    +

    This option has some usage constraints. It: +

      +
    • must not appear in combination with any of the following options: +command. +
    + +

    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. +


    -


    -Next: , -Previous: ntpdc listpeers, -Up: ntpdc Invocation - +
    +

    +Next: , Previous: , Up: ntpdc Invocation  

    + +

    1.1.7 numeric option (-n)

    + -

    numeric option (-n)

    - -

    -This is the “numeric host addresses” option. +

    This is the “numeric host addresses” option. Output all host addresses in dotted-quad numeric format rather than converting to the canonical host names. -

    +


    -


    -Next: , -Previous: ntpdc numeric, -Up: ntpdc Invocation - +
    +

    +Next: , Previous: , Up: ntpdc Invocation  

    - -

    peers option (-p)

    - -

    -This is the “print a list of the peers” option. - -

    This option has some usage constraints. It: -

      -
    • must not appear in combination with any of the following options: -command. -
    - -

    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. -

    + +

    1.1.8 peers option (-p)

    + + +

    This is the “print a list of the peers” option. +

    +

    This option has some usage constraints. It: +

      +
    • must not appear in combination with any of the following options: +command. +
    + +

    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. +


    -


    -Next: , -Previous: ntpdc peers, -Up: ntpdc Invocation - +
    +

    +Next: , Previous: , Up: ntpdc Invocation  

    - -

    showpeers option (-s)

    - -

    -This is the “show a list of the peers” option. - -

    This option has some usage constraints. It: -

      -
    • must not appear in combination with any of the following options: -command. -
    - -

    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. - -

    + +

    1.1.9 showpeers option (-s)

    + + +

    This is the “show a list of the peers” option. +

    +

    This option has some usage constraints. It: +

      +
    • must not appear in combination with any of the following options: +command. +
    + +

    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. +

    + +
    -


    -Next: , -Previous: ntpdc showpeers, -Up: ntpdc Invocation - +
    +

    +Next: , Previous: , Up: ntpdc Invocation  

    - -

    presetting/configuring ntpdc

    + +

    1.1.10 presetting/configuring ntpdc

    Any option that is not marked as not presettable may be preset by -loading values from configuration ("rc" or "ini") files, and values from environment variables named NTPDC and NTPDC_<OPTION_NAME>. <OPTION_NAME> 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 NTPDC and NTPDC_<OPTION_NAME>. <OPTION_NAME> must be one of +the options listed above in upper case and segmented with underscores. The NTPDC 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. - -

    libopts will search in 2 places for configuration files: -

      -
    • $HOME -
    • $PWD -
    - The environment variables HOME, and PWD -are expanded and replaced when ntpdc runs. -For any of these that are plain files, they are simply processed. -For any that are directories, then a file named .ntprc is searched for +

    + +

    libopts will search in 2 places for configuration files: +

      +
    • $HOME +
    • $PWD +
    +

    The environment variables HOME, and PWD +are expanded and replaced when ntpdc runs. +For any of these that are plain files, they are simply processed. +For any that are directories, then a file named .ntprc is searched for within that directory and processed. - -

    Configuration files may be in a wide variety of formats. +

    +

    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. - -

    Multiple programs may also share the same initialization file. +

    +

    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: -

        [NTPDC]
    -
    -

    or by -

        <?program ntpdc>
    -
    -

    Do not mix these styles within one configuration file. - -

    Compound values and carefully constructed string values may also be +

    +
    [NTPDC]
    +
    +

    or by +

    +
    <?program ntpdc>
    +
    +

    Do not mix these styles within one configuration file. +

    +

    Compound values and carefully constructed string values may also be specified using XML syntax: -

        <option-name>
    -       <sub-opt>...&lt;...&gt;...</sub-opt>
    -    </option-name>
    -
    -

    yielding an option-name.sub-opt string value of -

        "...<...>..."
    -
    -

    AutoOpts does not track suboptions. You simply note that it is a +

    +
    <option-name>
    +   <sub-opt>...&lt;...&gt;...</sub-opt>
    +</option-name>
    +
    +

    yielding an option-name.sub-opt string value of +

    +
    "...<...>..."
    +
    +

    AutoOpts does not track suboptions. You simply note that it is a hierarchicly valued option. AutoOpts does provide a means for searching the associated name/value pair list (see: optionFindValue). - -

    The command line options relating to configuration and/or usage help are: - -

    version (-)
    +

    +

    The command line options relating to configuration and/or usage help are: +

    + +

    version (-)

    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: - -

    -
    version
    Only print the version. This is the default. -
    copyright
    Name the copyright usage licensing terms. -
    verbose
    Print the full copyright usage licensing terms. +

    +
    +
    version
    +

    Only print the version. This is the default. +

    +
    copyright
    +

    Name the copyright usage licensing terms. +

    +
    verbose
    +

    Print the full copyright usage licensing terms. +

    -
    +
    -


    -Next: , -Previous: ntpdc config, -Up: ntpdc Invocation - +
    +

    +Next: , Previous: , Up: ntpdc Invocation  

    - -

    ntpdc exit status

    + +

    1.1.11 ntpdc exit status

    One of the following exit values will be returned: -

    -
    0 (EXIT_SUCCESS)
    Successful program execution. -
    1 (EXIT_FAILURE)
    The operation failed or the command syntax was not valid. -
    66 (EX_NOINPUT)
    A specified configuration file could not be loaded. -
    70 (EX_SOFTWARE)
    libopts had an internal operational error. Please report -it to autogen-users@lists.sourceforge.net. Thank you. +

    +
    0 (EXIT_SUCCESS)
    +

    Successful program execution. +

    +
    1 (EXIT_FAILURE)
    +

    The operation failed or the command syntax was not valid. +

    +
    66 (EX_NOINPUT)
    +

    A specified configuration file could not be loaded. +

    +
    70 (EX_SOFTWARE)
    +

    libopts had an internal operational error. Please report +it to autogen-users@lists.sourceforge.net. Thank you. +

    -
    +
    -


    -Next: , -Previous: ntpdc exit status, -Up: ntpdc Invocation - +
    +

    +Next: , Previous: , Up: ntpdc Invocation  

    - -

    ntpdc Usage

    - -
    + +

    1.1.12 ntpdc Usage

    +
    -


    -Next: , -Previous: ntpdc Usage, -Up: ntpdc Invocation - +
    +

    +Next: , Previous: , Up: ntpdc Invocation  

    - -

    ntpdc See Also

    - -
    + +

    1.1.13 ntpdc See Also

    +
    -


    -Next: , -Previous: ntpdc See Also, -Up: ntpdc Invocation - +
    +

    +Next: , Previous: , Up: ntpdc Invocation  

    - -

    ntpdc Authors

    - -
    + +

    1.1.14 ntpdc Authors

    +
    -


    -Previous: ntpdc Authors, -Up: ntpdc Invocation - +
    +

    +Previous: , Up: ntpdc Invocation  

    + +

    1.1.15 ntpdc Bugs

    -

    ntpdc Bugs

    - -
    +
    -


    - - +
    +

    +Previous: , Up: ntpdc Description  

    - - -

    Usage

    + +

    1.2 Usage

    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: +

    +
    +
    ntpdc ntpserver.somewhere
    +
    -
        ntpdc ntpserver.somewhere
    -
    -

    With suitable privilege, it can be run as a command or in a +

    With suitable privilege, it can be run as a command or in a cron job to reset the local clock from a reliable server, like -the ntpdate and rdate commands. +the ntpdate and rdate commands. For example: +

    +
    +
    ntpdc -a ntpserver.somewhere
    +
    +
    + -
        ntpdc -a ntpserver.somewhere
    -
    - + + diff --git a/ntpdc/ntpdc.man.in b/ntpdc/ntpdc.man.in index b198cf23c..c71e69183 100644 --- a/ntpdc/ntpdc.man.in +++ b/ntpdc/ntpdc.man.in @@ -10,11 +10,11 @@ .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 diff --git a/ntpdc/ntpdc.mdoc.in b/ntpdc/ntpdc.mdoc.in index 73dad5624..f7504fc8f 100644 --- a/ntpdc/ntpdc.mdoc.in +++ b/ntpdc/ntpdc.mdoc.in @@ -1,9 +1,9 @@ -.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 diff --git a/ntpq/invoke-ntpq.texi b/ntpq/invoke-ntpq.texi index 50d9d8075..6d449cad3 100644 --- a/ntpq/invoke-ntpq.texi +++ b/ntpq/invoke-ntpq.texi @@ -6,7 +6,7 @@ # # 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 diff --git a/ntpq/ntpq-opts.c b/ntpq/ntpq-opts.c index 9d6511085..54a73ae5f 100644 --- a/ntpq/ntpq-opts.c +++ b/ntpq/ntpq-opts.c @@ -1,11 +1,11 @@ /* * 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 diff --git a/ntpq/ntpq-opts.h b/ntpq/ntpq-opts.h index f4075b45f..5f0cf8ce1 100644 --- a/ntpq/ntpq-opts.h +++ b/ntpq/ntpq-opts.h @@ -1,11 +1,11 @@ /* * 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 @@ -53,7 +53,7 @@ * 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 diff --git a/ntpq/ntpq.1ntpqman b/ntpq/ntpq.1ntpqman index f7db18575..e46e8402b 100644 --- a/ntpq/ntpq.1ntpqman +++ b/ntpq/ntpq.1ntpqman @@ -10,11 +10,11 @@ .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 diff --git a/ntpq/ntpq.1ntpqmdoc b/ntpq/ntpq.1ntpqmdoc index 0763a2162..053b91a73 100644 --- a/ntpq/ntpq.1ntpqmdoc +++ b/ntpq/ntpq.1ntpqmdoc @@ -1,9 +1,9 @@ -.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 diff --git a/ntpq/ntpq.html b/ntpq/ntpq.html index 5d98ebbb6..8a68fc8e9 100644 --- a/ntpq/ntpq.html +++ b/ntpq/ntpq.html @@ -1293,7 +1293,7 @@ used to select the program, defaulting to more. Both will exit with a status code of 0.

    -
    ntpq - standard NTP query program - Ver. 4.2.8p13
    +
    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
    diff --git a/ntpq/ntpq.man.in b/ntpq/ntpq.man.in
    index 49bfd96b3..584fade08 100644
    --- a/ntpq/ntpq.man.in
    +++ b/ntpq/ntpq.man.in
    @@ -10,11 +10,11 @@
     .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
    diff --git a/ntpq/ntpq.mdoc.in b/ntpq/ntpq.mdoc.in
    index 64db19e5a..c87aaec14 100644
    --- a/ntpq/ntpq.mdoc.in
    +++ b/ntpq/ntpq.mdoc.in
    @@ -1,9 +1,9 @@
    -.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
    diff --git a/ntpsnmpd/invoke-ntpsnmpd.texi b/ntpsnmpd/invoke-ntpsnmpd.texi
    index 803417058..8b766040b 100644
    --- a/ntpsnmpd/invoke-ntpsnmpd.texi
    +++ b/ntpsnmpd/invoke-ntpsnmpd.texi
    @@ -6,7 +6,7 @@
     #
     # 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
    diff --git a/ntpsnmpd/ntpsnmpd-opts.c b/ntpsnmpd/ntpsnmpd-opts.c
    index 9c5bbd838..adb96eecb 100644
    --- a/ntpsnmpd/ntpsnmpd-opts.c
    +++ b/ntpsnmpd/ntpsnmpd-opts.c
    @@ -1,11 +1,11 @@
     /*
      *  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
    diff --git a/ntpsnmpd/ntpsnmpd-opts.h b/ntpsnmpd/ntpsnmpd-opts.h
    index df426318a..3a1b478a3 100644
    --- a/ntpsnmpd/ntpsnmpd-opts.h
    +++ b/ntpsnmpd/ntpsnmpd-opts.h
    @@ -1,11 +1,11 @@
     /*
      *  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
    @@ -53,7 +53,7 @@
      *  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
    diff --git a/ntpsnmpd/ntpsnmpd.1ntpsnmpdman b/ntpsnmpd/ntpsnmpd.1ntpsnmpdman
    index 1f066476e..e7cbea0ab 100644
    --- a/ntpsnmpd/ntpsnmpd.1ntpsnmpdman
    +++ b/ntpsnmpd/ntpsnmpd.1ntpsnmpdman
    @@ -10,11 +10,11 @@
     .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
    diff --git a/ntpsnmpd/ntpsnmpd.1ntpsnmpdmdoc b/ntpsnmpd/ntpsnmpd.1ntpsnmpdmdoc
    index be76f813d..2ec072e48 100644
    --- a/ntpsnmpd/ntpsnmpd.1ntpsnmpdmdoc
    +++ b/ntpsnmpd/ntpsnmpd.1ntpsnmpdmdoc
    @@ -1,9 +1,9 @@
    -.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
    diff --git a/ntpsnmpd/ntpsnmpd.man.in b/ntpsnmpd/ntpsnmpd.man.in
    index dd74e8193..37ac916dd 100644
    --- a/ntpsnmpd/ntpsnmpd.man.in
    +++ b/ntpsnmpd/ntpsnmpd.man.in
    @@ -10,11 +10,11 @@
     .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
    diff --git a/ntpsnmpd/ntpsnmpd.mdoc.in b/ntpsnmpd/ntpsnmpd.mdoc.in
    index f3cb9beac..7426efe00 100644
    --- a/ntpsnmpd/ntpsnmpd.mdoc.in
    +++ b/ntpsnmpd/ntpsnmpd.mdoc.in
    @@ -1,9 +1,9 @@
    -.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
    diff --git a/scripts/calc_tickadj/calc_tickadj.1calc_tickadjman b/scripts/calc_tickadj/calc_tickadj.1calc_tickadjman
    index 7c0ab6bcf..2cf18875a 100644
    --- a/scripts/calc_tickadj/calc_tickadj.1calc_tickadjman
    +++ b/scripts/calc_tickadj/calc_tickadj.1calc_tickadjman
    @@ -10,11 +10,11 @@
     .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
    diff --git a/scripts/calc_tickadj/calc_tickadj.1calc_tickadjmdoc b/scripts/calc_tickadj/calc_tickadj.1calc_tickadjmdoc
    index 71eab8486..e1f0e0b39 100644
    --- a/scripts/calc_tickadj/calc_tickadj.1calc_tickadjmdoc
    +++ b/scripts/calc_tickadj/calc_tickadj.1calc_tickadjmdoc
    @@ -1,9 +1,9 @@
    -.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
    diff --git a/scripts/calc_tickadj/calc_tickadj.html b/scripts/calc_tickadj/calc_tickadj.html
    index bbdea3c78..c979abd50 100644
    --- a/scripts/calc_tickadj/calc_tickadj.html
    +++ b/scripts/calc_tickadj/calc_tickadj.html
    @@ -1,121 +1,156 @@
    -
    +
    +
    +
     
    -calc_tickadj User's Manual
    -
    -
    -
    -
    -
    -
    -
    +
    +calc_tickadj User’s Manual
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
     
    -
    -

    calc_tickadj User's Manual

    -
    - -


    -Next: , -Previous: (dir), -Up: (dir) -
    + +

    calc_tickadj User’s Manual

    -

    calc_tickadj User's Manual

    -

    This document describes the use of the NTP Project's calc_tickadj program. -This document applies to version 4.2.8p13 of calc_tickadj. -

    -

    Short Contents

    -
      -calc_tickadj User's Manual + + +
      +

      +Previous: , Up: (dir)  

      +
      + +

      calc_tickadj User’s Manual

      + +

      This document describes the use of the NTP Project’s calc_tickadj program. +This document applies to version 4.2.8p13-foo of calc_tickadj. +

      + +

      Short Table of Contents

      + + - -
      - - -


      -Previous: calc_tickadj Description, -Up: Top + + + + +
      + +
      +

      +Up: Top  

      + +

      1 Invoking calc_tickadj

      + + -

      Invoking calc_tickadj

      - -

      -The calc_tickadj script uses provided ntp drift file to generate optimal +

      The calc_tickadj 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. - -

      The example output of -

           $ ./calc_tickadj
      -     81.699 (drift)
      -     9999 usec; 9999779 nsec
      -     $ cat /etc/ntp/drift
      -     -23.159
      -
      -

      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. +

      +

      The example output of +

      +
      $ ./calc_tickadj
      +81.699 (drift)
      +9999 usec; 9999779 nsec
      +$ cat /etc/ntp/drift
      +-23.159
      +
      + +

      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. - -

      If 'tick' on that box is 10,000,000 then by setting it to 9999779 the drift +

      +

      If ’tick’ on that box is 10,000,000 then by setting it to 9999779 the drift value will be somewhere around 0.0. - -

      calc_tickadj tries to determine the the tick value by using -tickadj program from ntp package. If this doesn't work you can specify +

      +

      calc_tickadj tries to determine the the tick value by using +tickadj program from ntp package. If this doesn’t work you can specify current tick manually on command line. +

      -

      This section was generated by AutoGen, +

      This section was generated by AutoGen, using the agtexi-cmd template and the option descriptions for the calc_tickadj program. - -

      - -
      - +

      + + + + + + + +
      -


      -Next: , -Up: calc_tickadj Invocation - + - -

      calc_tickadj help/usage (--help)

      - -

      -This is the automatically generated usage text for calc_tickadj. - -

      The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print -the usage text by passing it through a pager program. + +

      1.1 calc_tickadj help/usage (--help)

      + + +

      This is the automatically generated usage text for calc_tickadj. +

      +

      The text printed is the same whether selected with the help option +(--help) or the more-help option (--more-help). more-help will print +the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0. - -

      calc_tickadj - Calculates "optimal" value for tick given ntp drift file. - Ver. 4.2.7p467
      -USAGE: calc_tickadj [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
      +

      +
      +
      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
      @@ -124,55 +159,64 @@ USAGE: calc_tickadj [ -<flag> [<val>] | --<name>[{=| }<val&
       
       Options are specified by doubled hyphens and their name or by a single
       hyphen and the flag character.
      -
      -
      - +
      + + + + + + + +
      -


      -Next: , -Previous: calc_tickadj usage, -Up: calc_tickadj Invocation - + + +

      1.1.1 drift-file option (-d)

      + -

      drift-file option (-d)

      - -

      -This is the “ntp drift file to use” option. -This option takes a string argument. +

      This is the “ntp drift file to use” option. +This option takes a string argument. Use the specified drift file for calculations -

      - +


      -


      -Next: , -Previous: calc_tickadj drift-file, -Up: calc_tickadj Invocation - + + +

      1.1.2 tick option (-t)

      + -

      tick option (-t)

      - -

      -This is the “tick value of this host” option. -This option takes a number argument. +

      This is the “tick value of this host” option. +This option takes a number argument. The current tick which to adjustment will be calculated -

      - +


      -


      -Previous: calc_tickadj tick, -Up: calc_tickadj Invocation - +
      +

      +Previous: , Up: calc_tickadj usage  

      - -

      calc_tickadj exit status

      + +

      1.1.3 calc_tickadj exit status

      One of the following exit values will be returned: -

      -
      0 (EXIT_SUCCESS)
      Successful program execution. -
      1 (EXIT_FAILURE)
      The operation failed or the command syntax was not valid. +

      +
      0 (EXIT_SUCCESS)
      +

      Successful program execution. +

      +
      1 (EXIT_FAILURE)
      +

      The operation failed or the command syntax was not valid. +

      +
      + - + + diff --git a/scripts/calc_tickadj/calc_tickadj.man.in b/scripts/calc_tickadj/calc_tickadj.man.in index 7c0ab6bcf..2cf18875a 100644 --- a/scripts/calc_tickadj/calc_tickadj.man.in +++ b/scripts/calc_tickadj/calc_tickadj.man.in @@ -10,11 +10,11 @@ .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 diff --git a/scripts/calc_tickadj/calc_tickadj.mdoc.in b/scripts/calc_tickadj/calc_tickadj.mdoc.in index 71eab8486..e1f0e0b39 100644 --- a/scripts/calc_tickadj/calc_tickadj.mdoc.in +++ b/scripts/calc_tickadj/calc_tickadj.mdoc.in @@ -1,9 +1,9 @@ -.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 diff --git a/scripts/calc_tickadj/invoke-calc_tickadj.texi b/scripts/calc_tickadj/invoke-calc_tickadj.texi index 15a1ae4b2..535118503 100644 --- a/scripts/calc_tickadj/invoke-calc_tickadj.texi +++ b/scripts/calc_tickadj/invoke-calc_tickadj.texi @@ -6,7 +6,7 @@ # # 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 @@ -63,7 +63,7 @@ with a status code of 0. @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 [ - [] | --[@{=| @}] ]... -d, --drift-file=str Ntp drift file to use diff --git a/scripts/invoke-plot_summary.texi b/scripts/invoke-plot_summary.texi index c827c0e33..568950bf7 100644 --- a/scripts/invoke-plot_summary.texi +++ b/scripts/invoke-plot_summary.texi @@ -6,7 +6,7 @@ # # 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 @@ -41,7 +41,7 @@ with a status code of 0. @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 [ - [] | --[@{=| @}] ]... --directory=str Where the summary files are diff --git a/scripts/invoke-summary.texi b/scripts/invoke-summary.texi index 647dcab0f..1d2a7dd45 100644 --- a/scripts/invoke-summary.texi +++ b/scripts/invoke-summary.texi @@ -6,7 +6,7 @@ # # 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 @@ -42,7 +42,7 @@ with a status code of 0. @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 [ - [] | --[@{=| @}] ]... --directory=str Directory containing stat files diff --git a/scripts/ntp-wait/invoke-ntp-wait.texi b/scripts/ntp-wait/invoke-ntp-wait.texi index 925c2d72b..cc5d51cc9 100644 --- a/scripts/ntp-wait/invoke-ntp-wait.texi +++ b/scripts/ntp-wait/invoke-ntp-wait.texi @@ -6,7 +6,7 @@ # # 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 @@ -61,7 +61,7 @@ with a status code of 0. @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 [ - [] | --[@{=| @}] ]... -n, --tries=num Number of times to check ntpd diff --git a/scripts/ntp-wait/ntp-wait-opts b/scripts/ntp-wait/ntp-wait-opts index 6a9e3a610..bff9ebca5 100644 --- a/scripts/ntp-wait/ntp-wait-opts +++ b/scripts/ntp-wait/ntp-wait-opts @@ -1,6 +1,6 @@ # 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 @@ -40,7 +40,7 @@ sub processOptions { '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 [ - [] | --[{=| }] ]... -n, --tries=num Number of times to check ntpd diff --git a/scripts/ntp-wait/ntp-wait.1ntp-waitman b/scripts/ntp-wait/ntp-wait.1ntp-waitman index 866824f02..ba63a5f02 100644 --- a/scripts/ntp-wait/ntp-wait.1ntp-waitman +++ b/scripts/ntp-wait/ntp-wait.1ntp-waitman @@ -10,11 +10,11 @@ .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 diff --git a/scripts/ntp-wait/ntp-wait.1ntp-waitmdoc b/scripts/ntp-wait/ntp-wait.1ntp-waitmdoc index bbe61a7d6..2db9c05f7 100644 --- a/scripts/ntp-wait/ntp-wait.1ntp-waitmdoc +++ b/scripts/ntp-wait/ntp-wait.1ntp-waitmdoc @@ -1,9 +1,9 @@ -.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 diff --git a/scripts/ntp-wait/ntp-wait.html b/scripts/ntp-wait/ntp-wait.html index 125c1a328..b79c19b66 100644 --- a/scripts/ntp-wait/ntp-wait.html +++ b/scripts/ntp-wait/ntp-wait.html @@ -1,72 +1,105 @@ - + + + -Ntp-wait User's Manual - - - - - - - + +Ntp-wait User’s Manual + + + + + + + + + + + - -

      Ntp-wait User's Manual

      -
      - -


      -Next: , -Previous: (dir), -Up: (dir) -
      + +

      Ntp-wait User’s Manual

      + -

      This document describes the use of the NTP Project's ntp-wait program. -

      If there are time-sensitive applications, + + + +

      +

      +Previous: , Up: (dir)  

      +
      +

      Top

      + +

      This document describes the use of the NTP Project’s ntp-wait program. +

      +

      If there are time-sensitive applications, the proper sequence of events is to run ntpd -g as early as possible, then invoke all of the non-time-sensitive process, run ntp-wait 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. - -

      This document applies to version 4.2.8p13 of ntp-wait. +

      +

      This document applies to version 4.2.8p13-foo of ntp-wait. +

      + +

      Short Table of Contents

      -

      Short Contents

      -
        -
      +
    • 1 Invoking ntp-wait
    • +
      - - -
      - - -


      + + + + +
      + +
      +

      +Up: Top  

      + +

      1 Invoking ntp-wait

      + + -

      0.1 Invoking ntp-wait

      -

      -

      ntp-wait +

      ntp-wait will send at most num-tries queries to @@ -76,52 +109,58 @@ sleeping for after each status return that says ntpd(8) has not yet produced a synchronized and stable system clock. - -

      ntp-wait +

      +

      ntp-wait will do this quietly, unless the -v -flag is provided. +flag is provided. This can be useful at boot time, to delay the boot sequence until after ntpd -g has set the time. - -

      This section was generated by AutoGen, +

      +

      This section was generated by AutoGen, using the agtexi-cmd template and the option descriptions for the ntp-wait program. - -

      - -
      - +

      + + + + + + + + + + +
      -


      -Next: , -Up: ntp-wait Invocation - + - -

      0.1.1 ntp-wait help/usage (--help)

      - -

      -This is the automatically generated usage text for ntp-wait. - -

      The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print -the usage text by passing it through a pager program. + +

      1.1 ntp-wait help/usage (--help)

      + + +

      This is the automatically generated usage text for ntp-wait. +

      +

      The text printed is the same whether selected with the help option +(--help) or the more-help option (--more-help). more-help will print +the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0. - -

      ntp-wait - Wait for ntpd to stabilize the system clock - Ver. 4.2.8p13
      -USAGE: ntp-wait [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
      +

      +
      +
      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
      @@ -131,96 +170,86 @@ USAGE: ntp-wait [ -<flag> [<val>] | --<name>[{=| }<val>]
       
       Options are specified by doubled hyphens and their name or by a single
       hyphen and the flag character.
      -
      -
      - - -


      -Next: , -Previous: ntp-wait usage, -Up: ntp-wait Invocation +
      +
      + +
      +

      +Next: , Previous: , Up: ntp-wait Invocation  

      + +

      1.2 tries option (-n)

      + -

      0.1.2 tries option (-n)

      - -

      -This is the “number of times to check ntpd” option. -This option takes a number argument. +

      This is the “number of times to check ntpd” option. +This option takes a number argument. The maximum number of times we will check ntpd to see if - it has been able to synchronize and stabilize the system clock. -

      - + it has been able to synchronize and stabilize the system clock. +


      -


      -Next: , -Previous: ntp-wait tries, -Up: ntp-wait Invocation - + - -

      0.1.3 sleep option (-s)

      - -

      -This is the “how long to sleep between tries” option. -This option takes a number argument secs-between-tries. - We will sleep for secs-between-tries after each query - of ntpd that returns "the time is not yet stable". -

      - + +

      1.3 sleep option (-s)

      + + +

      This is the “how long to sleep between tries” option. +This option takes a number argument secs-between-tries. + We will sleep for secs-between-tries after each query + of ntpd that returns "the time is not yet stable". +


      -


      -Next: , -Previous: ntp-wait sleep, -Up: ntp-wait Invocation - + - -

      0.1.4 verbose option (-v)

      - -

      -This is the “be verbose” option. - By default, ntp-wait is silent. - With this option, ntp-wait will provide status information. -

      - + +

      1.4 verbose option (-v)

      + + +

      This is the “be verbose” option. + By default, ntp-wait is silent. + With this option, ntp-wait will provide status information. +


      -


      -Next: , -Previous: ntp-wait verbose, -Up: ntp-wait Invocation - + - -

      0.1.5 ntp-wait exit status

      + +

      1.5 ntp-wait exit status

      One of the following exit values will be returned: -

      -
      0 (EXIT_SUCCESS)
      Successful program execution. -
      1 (EXIT_FAILURE)
      The operation failed or the command syntax was not valid. +

      +
      0 (EXIT_SUCCESS)
      +

      Successful program execution. +

      +
      1 (EXIT_FAILURE)
      +

      The operation failed or the command syntax was not valid. +

      -
      - +
      -


      -Next: , -Previous: ntp-wait exit status, -Up: ntp-wait Invocation - + - -

      0.1.6 ntp-wait Authors

      - -
      - + +

      1.6 ntp-wait Authors

      +
      -


      -Previous: ntp-wait Authors, -Up: ntp-wait Invocation - +
      +

      +Previous: , Up: ntp-wait Invocation  

      + +

      1.7 ntp-wait Notes

      +
      -

      0.1.7 ntp-wait Notes

      - + + diff --git a/scripts/ntp-wait/ntp-wait.man.in b/scripts/ntp-wait/ntp-wait.man.in index 7e52ea232..769633953 100644 --- a/scripts/ntp-wait/ntp-wait.man.in +++ b/scripts/ntp-wait/ntp-wait.man.in @@ -10,11 +10,11 @@ .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 diff --git a/scripts/ntp-wait/ntp-wait.mdoc.in b/scripts/ntp-wait/ntp-wait.mdoc.in index 8c486fc56..c28a3ff22 100644 --- a/scripts/ntp-wait/ntp-wait.mdoc.in +++ b/scripts/ntp-wait/ntp-wait.mdoc.in @@ -1,9 +1,9 @@ -.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 diff --git a/scripts/ntpsweep/invoke-ntpsweep.texi b/scripts/ntpsweep/invoke-ntpsweep.texi index f3e7a944e..c645ff72e 100644 --- a/scripts/ntpsweep/invoke-ntpsweep.texi +++ b/scripts/ntpsweep/invoke-ntpsweep.texi @@ -6,7 +6,7 @@ # # 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 @@ -45,7 +45,7 @@ with a status code of 0. @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 [ - [] | --[@{=| @}] ]... [hostfile] -l, --host-list=str Host to execute actions on diff --git a/scripts/ntpsweep/ntpsweep-opts b/scripts/ntpsweep/ntpsweep-opts index 7bfaab397..47a6e7209 100644 --- a/scripts/ntpsweep/ntpsweep-opts +++ b/scripts/ntpsweep/ntpsweep-opts @@ -1,6 +1,6 @@ # 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 @@ -43,7 +43,7 @@ sub processOptions { '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 [ - [] | --[{=| }] ]... [hostfile] -l, --host-list=str Host to execute actions on diff --git a/scripts/ntpsweep/ntpsweep.1ntpsweepman b/scripts/ntpsweep/ntpsweep.1ntpsweepman index d5691c4bc..911e68642 100644 --- a/scripts/ntpsweep/ntpsweep.1ntpsweepman +++ b/scripts/ntpsweep/ntpsweep.1ntpsweepman @@ -10,11 +10,11 @@ .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 diff --git a/scripts/ntpsweep/ntpsweep.1ntpsweepmdoc b/scripts/ntpsweep/ntpsweep.1ntpsweepmdoc index a82b45bc6..a1dffe4c3 100644 --- a/scripts/ntpsweep/ntpsweep.1ntpsweepmdoc +++ b/scripts/ntpsweep/ntpsweep.1ntpsweepmdoc @@ -1,9 +1,9 @@ -.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 diff --git a/scripts/ntpsweep/ntpsweep.html b/scripts/ntpsweep/ntpsweep.html index f55d8edfb..93450c11d 100644 --- a/scripts/ntpsweep/ntpsweep.html +++ b/scripts/ntpsweep/ntpsweep.html @@ -1,100 +1,140 @@ - + + + -ntpsweep User's Manual - - - - - - - + +ntpsweep User’s Manual + + + + + + + + + + + - -

      ntpsweep User's Manual

      -
      - -


      -Next: , -Previous: (dir), -Up: (dir) -
      + +

      ntpsweep User’s Manual

      -

      This document describes the use of the NTP Project's ntpsweep program. -

      This document applies to version 4.2.8p13 of ntpsweep. -

      -

      Short Contents

      -
        -
      -
      - -
      - -


      + +
      +

      +Previous: , Up: (dir)  

      +
      +

      Top

      +

      This document describes the use of the NTP Project’s ntpsweep program. +

      +

      This document applies to version 4.2.8p13-foo of ntpsweep. +

      + +

      Short Table of Contents

      + + -

      0.1 Invoking ntpsweep

      -

      -ntpsweep + + + + + +


      + +
      +

      +Up: Top  

      +
      + +

      1 Invoking ntpsweep

      + + + +

      ntpsweep 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. - -

      This section was generated by AutoGen, +

      +

      This section was generated by AutoGen, using the agtexi-cmd template and the option descriptions for the ntpsweep program. - -

      - -
      +

      + + + + + + + + + + +
      -


      -Next: , -Up: ntpsweep Invocation - + - -

      0.1.1 ntpsweep help/usage (--help)

      - -

      -This is the automatically generated usage text for ntpsweep. - -

      The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print -the usage text by passing it through a pager program. + +

      1.1 ntpsweep help/usage (--help)

      + + +

      This is the automatically generated usage text for ntpsweep. +

      +

      The text printed is the same whether selected with the help option +(--help) or the more-help option (--more-help). more-help will print +the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0. - -

      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
      @@ -107,106 +147,102 @@ USAGE: ntpsweep [ -<flag> [<val>] | --<name>[{=| }<val>]
       
       Options are specified by doubled hyphens and their name or by a single
       hyphen and the flag character.
      -
      -
      - - -


      -Next: , -Previous: ntpsweep usage, -Up: ntpsweep Invocation +
      +
      + +
      +

      +Next: , Previous: , Up: ntpsweep Invocation  

      + +

      1.2 host-list option (-l)

      + -

      0.1.2 host-list option (-l)

      - -

      -This is the “host to execute actions on” option. +

      This is the “host to execute actions on” option. This option takes a string argument. - -

      This option has some usage constraints. It: -

        -
      • may appear an unlimited number of times. -
      - -

      Use this option to specify the host on which this script operates. - May appear multiple times. -

      +

      +

      This option has some usage constraints. It: +

        +
      • may appear an unlimited number of times. +
      + +

      Use this option to specify the host on which this script operates. + May appear multiple times. +


      -


      -Next: , -Previous: ntpsweep host-list, -Up: ntpsweep Invocation - + + +

      1.3 peers option (-p)

      + -

      0.1.3 peers option (-p)

      - -

      -This is the “recursively list all peers a host synchronizes to” option. -This option has no ‘doc’ documentation. -

      +

      This is the “recursively list all peers a host synchronizes to” option. +This option has no ‘doc’ documentation. +


      -


      -Next: , -Previous: ntpsweep peers, -Up: ntpsweep Invocation - +
      +

      +Next: , Previous: , Up: ntpsweep Invocation  

      - -

      0.1.4 maxlevel option (-m)

      - -

      -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 ‘doc’ documentation. -

      + +

      1.4 maxlevel option (-m)

      + + +

      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 ‘doc’ documentation. +


      -


      -Next: , -Previous: ntpsweep maxlevel, -Up: ntpsweep Invocation - + + +

      1.5 strip option (-s)

      + -

      0.1.5 strip option (-s)

      - -

      -This is the “strip this string from hostnames” option. -This option takes a string argument. -This option has no ‘doc’ documentation. -

      +

      This is the “strip this string from hostnames” option. +This option takes a string argument. +This option has no ‘doc’ documentation. +


      -


      -Next: , -Previous: ntpsweep strip, -Up: ntpsweep Invocation - + + +

      1.6 host option (-h)

      + -

      0.1.6 host option (-h)

      - -

      -This is the “specify a single host” option. -This option takes a string argument. -This option has no ‘doc’ documentation. - -

      NOTE: THIS OPTION IS DEPRECATED -

      +

      This is the “specify a single host” option. +This option takes a string argument. +This option has no ‘doc’ documentation. +

      +

      NOTE: THIS OPTION IS DEPRECATED +


      -


      -Previous: ntpsweep host, -Up: ntpsweep Invocation - +
      +

      +Previous: , Up: ntpsweep Invocation  

      - -

      0.1.7 ntpsweep exit status

      + +

      1.7 ntpsweep exit status

      One of the following exit values will be returned: -

      -
      0 (EXIT_SUCCESS)
      Successful program execution. -
      1 (EXIT_FAILURE)
      The operation failed or the command syntax was not valid. +

      +
      0 (EXIT_SUCCESS)
      +

      Successful program execution. +

      +
      1 (EXIT_FAILURE)
      +

      The operation failed or the command syntax was not valid. +

      +
      + - + + diff --git a/scripts/ntpsweep/ntpsweep.man.in b/scripts/ntpsweep/ntpsweep.man.in index d5691c4bc..911e68642 100644 --- a/scripts/ntpsweep/ntpsweep.man.in +++ b/scripts/ntpsweep/ntpsweep.man.in @@ -10,11 +10,11 @@ .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 diff --git a/scripts/ntpsweep/ntpsweep.mdoc.in b/scripts/ntpsweep/ntpsweep.mdoc.in index a82b45bc6..a1dffe4c3 100644 --- a/scripts/ntpsweep/ntpsweep.mdoc.in +++ b/scripts/ntpsweep/ntpsweep.mdoc.in @@ -1,9 +1,9 @@ -.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 diff --git a/scripts/ntptrace/invoke-ntptrace.texi b/scripts/ntptrace/invoke-ntptrace.texi index 5474e29f8..de359826e 100644 --- a/scripts/ntptrace/invoke-ntptrace.texi +++ b/scripts/ntptrace/invoke-ntptrace.texi @@ -6,7 +6,7 @@ # # 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 @@ -62,7 +62,7 @@ with a status code of 0. @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 [ - [] | --[@{=| @}] ]... [host] -n, --numeric Print IP addresses instead of hostnames diff --git a/scripts/ntptrace/ntptrace-opts b/scripts/ntptrace/ntptrace-opts index dff014b33..04b24519e 100644 --- a/scripts/ntptrace/ntptrace-opts +++ b/scripts/ntptrace/ntptrace-opts @@ -1,6 +1,6 @@ # 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 @@ -40,7 +40,7 @@ sub processOptions { '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 [ - [] | --[{=| }] ]... [host] -n, --numeric Print IP addresses instead of hostnames diff --git a/scripts/ntptrace/ntptrace.1ntptraceman b/scripts/ntptrace/ntptrace.1ntptraceman index b1bb86275..bff770e29 100644 --- a/scripts/ntptrace/ntptrace.1ntptraceman +++ b/scripts/ntptrace/ntptrace.1ntptraceman @@ -10,11 +10,11 @@ .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 diff --git a/scripts/ntptrace/ntptrace.1ntptracemdoc b/scripts/ntptrace/ntptrace.1ntptracemdoc index e2b2adfa9..d74052424 100644 --- a/scripts/ntptrace/ntptrace.1ntptracemdoc +++ b/scripts/ntptrace/ntptrace.1ntptracemdoc @@ -1,9 +1,9 @@ -.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 diff --git a/scripts/ntptrace/ntptrace.html b/scripts/ntptrace/ntptrace.html index f8032af1d..edd7e8c3b 100644 --- a/scripts/ntptrace/ntptrace.html +++ b/scripts/ntptrace/ntptrace.html @@ -1,117 +1,156 @@ - + + + -Ntptrace User's Manual - - - - - - - + +Ntptrace User’s Manual + + + + + + + + + + + - -

      Ntptrace User's Manual

      -
      - -


      -Next: , -Previous: (dir), -Up: (dir) -
      + +

      Ntptrace User’s Manual

      + -

      Simple Network Time Protocol User Manual

      -

      This document describes the use of the NTP Project's ntptrace program. -This document applies to version 4.2.8p13 of ntptrace. -

      -

      Short Contents

      -
        -Simple Network Time Protocol User Manual + + +
        +

        +Previous: , Up: (dir)  

        +
        + +

        Simple Network Time Protocol User Manual

        + +

        This document describes the use of the NTP Project’s ntptrace program. +This document applies to version 4.2.8p13-foo of ntptrace. +

        + +

        Short Table of Contents

        + + - -
        - -


        -Previous: ntptrace Description, -Up: Top + + + + +
        + +
        +

        +Up: Top  

        + +

        1 Invoking ntptrace

        + + -

        Invoking ntptrace

        - -

        -ntptrace is a perl script that uses the ntpq utility program to follow +

        ntptrace 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. - -

        If given no arguments, ntptrace starts with localhost. Here is an example of +

        +

        If given no arguments, ntptrace starts with localhost. Here is an example of the output from ntptrace: - -

             % 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'
        -
        -

        On each line, the fields are (left to right): the host name, the host stratum, +

        +
        +
        % 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'
        +
        + +

        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 -ntptrace; this is why it is not always zero for "localhost"), the host +ntptrace; 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. +

        -

        This section was generated by AutoGen, +

        This section was generated by AutoGen, using the agtexi-cmd template and the option descriptions for the ntptrace program. - -

        - -
        +

        + + + + + + + + +
        -


        -Next: , -Up: ntptrace Invocation - + - -

        ntptrace help/usage (--help)

        - -

        -This is the automatically generated usage text for ntptrace. - -

        The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print -the usage text by passing it through a pager program. + +

        1.1 ntptrace help/usage (--help)

        + + +

        This is the automatically generated usage text for ntptrace. +

        +

        The text printed is the same whether selected with the help option +(--help) or the more-help option (--more-help). more-help will print +the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0. - -

        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
        @@ -122,68 +161,79 @@ USAGE: ntptrace [ -<flag> [<val>] | --<name>[{=| }<val>]
         
         Options are specified by doubled hyphens and their name or by a single
         hyphen and the flag character.
        -
        -
        +
        + + + + + + + + +
        -


        -Next: , -Previous: ntptrace usage, -Up: ntptrace Invocation - +
        +

        +Next: , Previous: , Up: ntptrace usage  

        + +

        1.1.1 numeric option (-n)

        + -

        numeric option (-n)

        - -

        -This is the “print ip addresses instead of hostnames” option. +

        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. -

        - +the canonical host names. +


        -


        -Next: , -Previous: ntptrace numeric, -Up: ntptrace Invocation - +
        +

        +Next: , Previous: , Up: ntptrace usage  

        - -

        max-hosts option (-m)

        - -

        -This is the “maximum number of peers to trace” option. -This option takes a number argument. -This option has no ‘doc’ documentation. -

        + +

        1.1.2 max-hosts option (-m)

        + + +

        This is the “maximum number of peers to trace” option. +This option takes a number argument. +This option has no ‘doc’ documentation. +


        -


        -Next: , -Previous: ntptrace max-hosts, -Up: ntptrace Invocation - + - -

        host option (-r)

        - -

        -This is the “single remote host” option. -This option takes a string argument. -This option has no ‘doc’ documentation. -

        + +

        1.1.3 host option (-r)

        + + +

        This is the “single remote host” option. +This option takes a string argument. +This option has no ‘doc’ documentation. +


        -


        -Previous: ntptrace host, -Up: ntptrace Invocation - +
        +

        +Previous: , Up: ntptrace usage  

        - -

        ntptrace exit status

        + +

        1.1.4 ntptrace exit status

        One of the following exit values will be returned: -

        -
        0 (EXIT_SUCCESS)
        Successful program execution. -
        1 (EXIT_FAILURE)
        The operation failed or the command syntax was not valid. +

        +
        0 (EXIT_SUCCESS)
        +

        Successful program execution. +

        +
        1 (EXIT_FAILURE)
        +

        The operation failed or the command syntax was not valid. +

        +
        + - + + diff --git a/scripts/ntptrace/ntptrace.man.in b/scripts/ntptrace/ntptrace.man.in index 737d5c736..5e90d0162 100644 --- a/scripts/ntptrace/ntptrace.man.in +++ b/scripts/ntptrace/ntptrace.man.in @@ -10,11 +10,11 @@ .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 diff --git a/scripts/ntptrace/ntptrace.mdoc.in b/scripts/ntptrace/ntptrace.mdoc.in index 1f2612b08..c9294de1f 100644 --- a/scripts/ntptrace/ntptrace.mdoc.in +++ b/scripts/ntptrace/ntptrace.mdoc.in @@ -1,9 +1,9 @@ -.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 diff --git a/scripts/plot_summary-opts b/scripts/plot_summary-opts index 17e92aa3b..98329e359 100644 --- a/scripts/plot_summary-opts +++ b/scripts/plot_summary-opts @@ -1,6 +1,6 @@ # 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 @@ -46,7 +46,7 @@ sub processOptions { '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 [ - [] | --[{=| }] ]... --directory=str Where the summary files are diff --git a/scripts/plot_summary.1plot_summaryman b/scripts/plot_summary.1plot_summaryman index a7e2d1acc..8975a8e60 100644 --- a/scripts/plot_summary.1plot_summaryman +++ b/scripts/plot_summary.1plot_summaryman @@ -10,11 +10,11 @@ .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 diff --git a/scripts/plot_summary.1plot_summarymdoc b/scripts/plot_summary.1plot_summarymdoc index c194336ae..df33ec187 100644 --- a/scripts/plot_summary.1plot_summarymdoc +++ b/scripts/plot_summary.1plot_summarymdoc @@ -1,9 +1,9 @@ -.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 diff --git a/scripts/plot_summary.html b/scripts/plot_summary.html index e9e2eb3d6..ba9935c2a 100644 --- a/scripts/plot_summary.html +++ b/scripts/plot_summary.html @@ -1,102 +1,138 @@ - + + + -Plot_summary User's Manual - - - - - - - + +Plot_summary User’s Manual + + + + + + + + + + + - -

        Plot_summary User's Manual

        -
        - -


        -Next: , -Previous: (dir), -Up: (dir) -
        + +

        Plot_summary User’s Manual

        + -

        Plot_summary User Manual

        -

        This document describes the use of the NTP Project's plot_summary program. -This document applies to version 4.2.8p13 of plot_summary. -

        -

        Short Contents

        -
          -Plot_summary User Manual + + +
          +

          +Previous: , Up: (dir)  

          +
          + +

          Plot_summary User Manual

          + +

          This document describes the use of the NTP Project’s plot_summary program. +This document applies to version 4.2.8p13-foo of plot_summary. +

          + +

          Short Table of Contents

          + + - -
          - - -


          -Previous: plot_summary Description, -Up: Top + + + + +
          + +
          +

          +Up: Top  

          + +

          1 Invoking plot_summary

          + + -

          Invoking plot_summary

          - -

          -

          This section was generated by AutoGen, +

          This section was generated by AutoGen, using the agtexi-cmd template and the option descriptions for the plot_summary program. - -

          - -
          - +

          + + + + + + + + + + +
          -


          -Next: , -Up: plot_summary Invocation - + - -

          plot_summary help/usage (--help)

          - -

          -This is the automatically generated usage text for plot_summary. - -

          The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print -the usage text by passing it through a pager program. + +

          1.1 plot_summary help/usage (--help)

          + + +

          This is the automatically generated usage text for plot_summary. +

          +

          The text printed is the same whether selected with the help option +(--help) or the more-help option (--more-help). more-help will print +the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0. - -

          plot_summary - plot statistics generated by summary script - Ver. 4.2.8p13
          -USAGE: plot_summary [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
          +

          +
          +
          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
          @@ -111,115 +147,121 @@ USAGE: plot_summary [ -<flag> [<val>] | --<name>[{=| }<val&
           
           Options are specified by doubled hyphens and their name or by a single
           hyphen and the flag character.
          -
          -
          - +
          + + + + + + + + + + +
          -


          -Next: , -Previous: plot_summary usage, -Up: plot_summary Invocation - + + +

          1.1.1 directory option

          + -

          directory option

          - -

          -This is the “where the summary files are” option. -This option takes a string argument. +

          This is the “where the summary files are” option. +This option takes a string argument. The directory where the plot_summary will search for the - *_summary files generated by summary script. -

          - + *_summary files generated by summary script. +


          -


          -Next: , -Previous: plot_summary directory, -Up: plot_summary Invocation - + + +

          1.1.2 identifier option

          + -

          identifier option

          - -

          -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 +

          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 -

          - +


          -


          -Next: , -Previous: plot_summary identifier, -Up: plot_summary Invocation - + + +

          1.1.3 peer option

          + -

          peer option

          - -

          -This is the “peers to generate plots for” option. +

          This is the “peers to generate plots for” option. This option takes a string argument. - -

          This option has some usage constraints. It: -

            -
          • may appear an unlimited number of times. -
          - -

          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. -

          - +

          +

          This option has some usage constraints. It: +

            +
          • may appear an unlimited number of times. +
          + +

          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. +


          -


          -Next: , -Previous: plot_summary peer, -Up: plot_summary Invocation - + + +

          1.1.4 plot-term option

          + -

          plot-term option

          - -

          -This is the “gnuplot terminal” option. -This option takes a string argument. +

          This is the “gnuplot terminal” option. +This option takes a string argument. This is string is passed directly to the gnuplot set terminal command. Default is x11 if DISPLAY is set and - dumb is it's not'. See output from -e "set - terminal") for the list of available options. -

          - + dumb is it’s not’. See output from (gnuplot -e "set + terminal") for the list of available options. +


          -


          -Next: , -Previous: plot_summary plot-term, -Up: plot_summary Invocation - + - -

          output-file option

          - -

          -This is the “output file” option. -This option takes a str argument. - Output file for gnuplot, default to stdout. -

          - + +

          1.1.5 output-file option

          + + +

          This is the “output file” option. +This option takes a str argument. + Output file for gnuplot, default to stdout. +


          -


          -Previous: plot_summary output-file, -Up: plot_summary Invocation - + - -

          plot_summary exit status

          + +

          1.1.6 plot_summary exit status

          One of the following exit values will be returned: -

          -
          0 (EXIT_SUCCESS)
          Successful program execution. -
          1 (EXIT_FAILURE)
          The operation failed or the command syntax was not valid. +

          +
          0 (EXIT_SUCCESS)
          +

          Successful program execution. +

          +
          1 (EXIT_FAILURE)
          +

          The operation failed or the command syntax was not valid. +

          +
          + - + + diff --git a/scripts/plot_summary.man.in b/scripts/plot_summary.man.in index a7e2d1acc..8975a8e60 100644 --- a/scripts/plot_summary.man.in +++ b/scripts/plot_summary.man.in @@ -10,11 +10,11 @@ .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 diff --git a/scripts/plot_summary.mdoc.in b/scripts/plot_summary.mdoc.in index c194336ae..df33ec187 100644 --- a/scripts/plot_summary.mdoc.in +++ b/scripts/plot_summary.mdoc.in @@ -1,9 +1,9 @@ -.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 diff --git a/scripts/summary-opts b/scripts/summary-opts index d07b0ca10..2c7f8ac55 100644 --- a/scripts/summary-opts +++ b/scripts/summary-opts @@ -1,6 +1,6 @@ # 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 @@ -44,7 +44,7 @@ sub processOptions { '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 [ - [] | --[{=| }] ]... --directory=str Directory containing stat files diff --git a/scripts/summary.1summaryman b/scripts/summary.1summaryman index d8be9c1cc..f73cac376 100644 --- a/scripts/summary.1summaryman +++ b/scripts/summary.1summaryman @@ -10,11 +10,11 @@ .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 diff --git a/scripts/summary.1summarymdoc b/scripts/summary.1summarymdoc index 55e756fb8..eb77ba24a 100644 --- a/scripts/summary.1summarymdoc +++ b/scripts/summary.1summarymdoc @@ -1,9 +1,9 @@ -.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 diff --git a/scripts/summary.html b/scripts/summary.html index 4e180b3ad..692e8ac0b 100644 --- a/scripts/summary.html +++ b/scripts/summary.html @@ -1,99 +1,138 @@ - + + + -Summary User's Manual - - - - - - - + +Summary User’s Manual + + + + + + + + + + + - -

          Summary User's Manual

          -
          - -


          -Next: , -Previous: (dir), -Up: (dir) -
          + +

          Summary User’s Manual

          -

          Summary User Manual

          -

          This document describes the use of the NTP Project's summary program. -This document applies to version 4.2.8p13 of summary. -

          -

          Short Contents

          -
            -Summary User Manual + + + +
            +

            +Previous: , Up: (dir)  

            +
            + +

            Summary User Manual

            + +

            This document describes the use of the NTP Project’s summary program. +This document applies to version 4.2.8p13-foo of summary. +

            + +

            Short Table of Contents

            + + - -
            - -


            -Previous: summary Description, -Up: Top + + + + +
            + +
            +

            +Up: Top  

            + +

            1 Invoking summary

            + + -

            Invoking summary

            - -

            -

            This section was generated by AutoGen, -using the agtexi-cmd template and the option descriptions for the summary program. -

            -
            +

            This section was generated by AutoGen, +using the agtexi-cmd template and the option descriptions for the summary program. +

            + + + + + + + + + +
            -


            -Next: , -Up: summary Invocation - + - -

            summary help/usage (--help)

            - -

            -This is the automatically generated usage text for summary. - -

            The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print -the usage text by passing it through a pager program. + +

            1.1 summary help/usage (--help)

            + + +

            This is the automatically generated usage text for summary. +

            +

            The text printed is the same whether selected with the help option +(--help) or the more-help option (--more-help). more-help will print +the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0. - -

            summary - compute various stastics from NTP stat files - Ver. 4.2.8p13
            -USAGE: summary [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
            +

            +
            +
            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
            @@ -106,89 +145,98 @@ USAGE: summary [ -<flag> [<val>] | --<name>[{=| }<val>]
             
             Options are specified by doubled hyphens and their name or by a single
             hyphen and the flag character.
            -
            -
            +
            + + + + + + + + + +
            -


            -Next: , -Previous: summary usage, -Up: summary Invocation - +
            +

            +Next: , Previous: , Up: summary usage  

            + +

            1.1.1 directory option

            + -

            directory option

            - -

            -This is the “directory containing stat files” option. -This option takes a string argument. +

            This is the “directory containing stat files” option. +This option takes a string argument. The directory where ntpd will search for .stat files generated - by ntpd. -

            - + by ntpd. +


            -


            -Next: , -Previous: summary directory, -Up: summary Invocation - + + +

            1.1.2 end-date option

            + -

            end-date option

            - -

            -This is the “end date” option. -This option takes a number argument. +

            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 date -u +%Y%m%d) - to get the timestamp. -

            - + to get the timestamp. +


            -


            -Next: , -Previous: summary end-date, -Up: summary Invocation - +
            +

            +Next: , Previous: , Up: summary usage  

            - -

            output-directory option

            - -

            -This is the “output directory” option. -This option takes a str argument. - The output directory summary will write all output files to. -

            - + +

            1.1.3 output-directory option

            + + +

            This is the “output directory” option. +This option takes a str argument. + The output directory summary will write all output files to. +


            -


            -Next: , -Previous: summary output-directory, -Up: summary Invocation - + + +

            1.1.4 start-date option

            + -

            start-date option

            - -

            -This is the “start date” option. -This option takes a num argument. +

            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. -

            + this option. Defaults to 197000101. +


            -


            -Previous: summary start-date, -Up: summary Invocation - +
            +

            +Previous: , Up: summary usage  

            - -

            summary exit status

            + +

            1.1.5 summary exit status

            One of the following exit values will be returned: -

            -
            0 (EXIT_SUCCESS)
            Successful program execution. -
            1 (EXIT_FAILURE)
            The operation failed or the command syntax was not valid. +

            +
            0 (EXIT_SUCCESS)
            +

            Successful program execution. +

            +
            1 (EXIT_FAILURE)
            +

            The operation failed or the command syntax was not valid. +

            +
            + - + + diff --git a/scripts/summary.man.in b/scripts/summary.man.in index d8be9c1cc..f73cac376 100644 --- a/scripts/summary.man.in +++ b/scripts/summary.man.in @@ -10,11 +10,11 @@ .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 diff --git a/scripts/summary.mdoc.in b/scripts/summary.mdoc.in index 55e756fb8..eb77ba24a 100644 --- a/scripts/summary.mdoc.in +++ b/scripts/summary.mdoc.in @@ -1,9 +1,9 @@ -.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 diff --git a/scripts/update-leap/invoke-update-leap.texi b/scripts/update-leap/invoke-update-leap.texi index 2cba50f50..1d8ff6122 100644 --- a/scripts/update-leap/invoke-update-leap.texi +++ b/scripts/update-leap/invoke-update-leap.texi @@ -6,7 +6,7 @@ # # 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 diff --git a/scripts/update-leap/update-leap-opts b/scripts/update-leap/update-leap-opts index d9f8f7a89..af8d7801c 100644 --- a/scripts/update-leap/update-leap-opts +++ b/scripts/update-leap/update-leap-opts @@ -1,6 +1,6 @@ # 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 @@ -46,7 +46,7 @@ sub processOptions { '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 [ - [] | --[{=| }] ]... -s, --source-url=str The URL of the master copy of the leapseconds file diff --git a/scripts/update-leap/update-leap.1update-leapman b/scripts/update-leap/update-leap.1update-leapman index 35a47baae..bf8d1c60f 100644 --- a/scripts/update-leap/update-leap.1update-leapman +++ b/scripts/update-leap/update-leap.1update-leapman @@ -10,11 +10,11 @@ .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 diff --git a/scripts/update-leap/update-leap.1update-leapmdoc b/scripts/update-leap/update-leap.1update-leapmdoc index 6dde51eb8..01efc6376 100644 --- a/scripts/update-leap/update-leap.1update-leapmdoc +++ b/scripts/update-leap/update-leap.1update-leapmdoc @@ -1,9 +1,9 @@ -.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 diff --git a/scripts/update-leap/update-leap.html b/scripts/update-leap/update-leap.html index becb66888..d33a190ac 100644 --- a/scripts/update-leap/update-leap.html +++ b/scripts/update-leap/update-leap.html @@ -59,7 +59,7 @@ Previous: , Up: This document describes the use of the NTP Project’s update-leap program.

            -

            This document applies to version 4.2.8p13 of update-leap. +

            This document applies to version 4.2.8p13-foo of update-leap.

            Short Table of Contents

            diff --git a/scripts/update-leap/update-leap.man.in b/scripts/update-leap/update-leap.man.in index 35a47baae..bf8d1c60f 100644 --- a/scripts/update-leap/update-leap.man.in +++ b/scripts/update-leap/update-leap.man.in @@ -10,11 +10,11 @@ .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 diff --git a/scripts/update-leap/update-leap.mdoc.in b/scripts/update-leap/update-leap.mdoc.in index 6dde51eb8..01efc6376 100644 --- a/scripts/update-leap/update-leap.mdoc.in +++ b/scripts/update-leap/update-leap.mdoc.in @@ -1,9 +1,9 @@ -.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 diff --git a/sntp/invoke-sntp.texi b/sntp/invoke-sntp.texi index 77dcf23c2..9cdab471b 100644 --- a/sntp/invoke-sntp.texi +++ b/sntp/invoke-sntp.texi @@ -6,7 +6,7 @@ # # 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 diff --git a/sntp/sntp-opts.c b/sntp/sntp-opts.c index 8a9a14a75..cf250477c 100644 --- a/sntp/sntp-opts.c +++ b/sntp/sntp-opts.c @@ -1,11 +1,11 @@ /* * 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 diff --git a/sntp/sntp-opts.h b/sntp/sntp-opts.h index 93cfd6d4e..25f6bddf3 100644 --- a/sntp/sntp-opts.h +++ b/sntp/sntp-opts.h @@ -1,11 +1,11 @@ /* * 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 @@ -53,7 +53,7 @@ * 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 diff --git a/sntp/sntp.1sntpman b/sntp/sntp.1sntpman index 8b66ab187..3e929b675 100644 --- a/sntp/sntp.1sntpman +++ b/sntp/sntp.1sntpman @@ -10,11 +10,11 @@ .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 diff --git a/sntp/sntp.1sntpmdoc b/sntp/sntp.1sntpmdoc index cdcf6e865..277445c8c 100644 --- a/sntp/sntp.1sntpmdoc +++ b/sntp/sntp.1sntpmdoc @@ -1,9 +1,9 @@ -.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 diff --git a/sntp/sntp.html b/sntp/sntp.html index 52f6cae2e..884553b04 100644 --- a/sntp/sntp.html +++ b/sntp/sntp.html @@ -1,186 +1,248 @@ - + + + -Sntp User's Manual - - - - - - - + +Sntp User’s Manual + + + + + + + + + + + - -

            Sntp User's Manual

            -
            - -


            -Next: , -Previous: (dir), -Up: (dir) -
            + +

            Sntp User’s Manual

            + + + -

            Simple Network Time Protocol User Manual

            -

            This document describes the use of the NTP Project's sntp program, + +

            +

            +Next: , Previous: , Up: (dir)  

            +
            + +

            Simple Network Time Protocol User Manual

            + +

            This document describes the use of the NTP Project’s sntp 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. - -

            This document applies to version 4.2.8p13 of sntp. - -

            The program implements the SNTP protocol as defined by RFC 5905, the NTPv4 +

            +

            This document applies to version 4.2.8p13 of sntp. +

            +

            The program implements the SNTP protocol as defined by RFC 5905, the NTPv4 IETF specification. +

            + +

            Short Table of Contents

            -
            -

            Short Contents

            -
              -Simple Network Time Protocol User Manual + - - -
              - -


              + + + + + +
              + +
              +

              +Next: , Up: Top  

              - - -

              Description

              + +

              1 Description

              By default, sntp writes the local data and time (i.e., not UTC) to the standard output in the format: +

              +
              +
              1996-10-15 20:17:25.123 (+0800) +4.567 +/- 0.089 secs
              +
              -
                   1996-10-15 20:17:25.123 (+0800) +4.567 +/- 0.089 secs
              -
              -

              where +

              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. - -

              +

              + + + + + +
              -


              - - +
              +

              +Next: , Previous: , Up: sntp Description  

              + +

              1.1 Invoking sntp

              + + -

              Invoking sntp

              -

              -

              sntp +

              sntp 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 cron job. - -

              NTP (the Network Time Protocol) and SNTP (the Simple Network Time Protocol) +

              +

              NTP (the Network Time Protocol) and SNTP (the Simple Network Time Protocol) are defined and described by RFC 5905. +

              -

              The default is to write the estimated correct local date and time (i.e. not +

              The default is to write the estimated correct local date and time (i.e. not UTC) to the standard output in a format like: - -

              '1996-10-15 20:17:25.123 (+0800) +4.567 +/- 0.089 [host] IP sN' - -

              where the +

              +

              '1996-10-15 20:17:25.123 (+0800) +4.567 +/- 0.089 [host] IP sN' +

              +

              where the '(+0800)' means that to get to UTC from the reported local time one must add 8 hours and 0 minutes, the '+4.567' 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. '+/- 0.089' is the reported synchronization distance -(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 -'+/- ?'. +'+/- ?'. If the host is different from the IP, -both will be displayed. -Otherwise, only the +both will be displayed. +Otherwise, only the IP -is displayed. +is displayed. Finally, the stratum of the host is reported and the leap indicator is decoded and displayed. - -

              This section was generated by AutoGen, -using the agtexi-cmd template and the option descriptions for the sntp program. +

              +

              This section was generated by AutoGen, +using the agtexi-cmd template and the option descriptions for the sntp program. This software is released under the NTP license, <http://ntp.org/license>. - -

              - -
              +

              + + + + + + + + + + + + + + + + + + + + + + +
              -


              -Next: , -Up: sntp Invocation - +
              +

              +Next: , Up: sntp Invocation  

              - -

              sntp help/usage (--help)

              - -

              -This is the automatically generated usage text for sntp. - -

              The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print -the usage text by passing it through a pager program. + +

              1.1.1 sntp help/usage (--help)

              + + +

              This is the automatically generated usage text for sntp. +

              +

              The text printed is the same whether selected with the help option +(--help) or the more-help option (--more-help). more-help will print +the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0. - +

              +
              sntp - standard Simple Network Time Protocol client program - Ver. 4.2.8p13
               Usage:  sntp [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \
                               [ hostname-or-IP ...]
              @@ -233,416 +295,408 @@ The following option preset mechanisms are supported:
                - examining environment variables named SNTP_*
               
               Please send bug reports to:  <http://bugs.ntp.org, bugs@ntp.org>
              -
              -
              - -


              -Next: , -Previous: sntp usage, -Up: sntp Invocation +
    +
    + +
    +

    +Next: , Previous: , Up: sntp Invocation  

    - -

    ipv4 option (-4)

    - -

    -This is the “force ipv4 dns name resolution” option. - -

    This option has some usage constraints. It: -

      -
    • must not appear in combination with any of the following options: -ipv6. -
    - -

    Force DNS resolution of the following host names on the command line -to the IPv4 namespace. -

    + +

    1.1.2 ipv4 option (-4)

    + + +

    This is the “force ipv4 dns name resolution” option. +

    +

    This option has some usage constraints. It: +

      +
    • must not appear in combination with any of the following options: +ipv6. +
    + +

    Force DNS resolution of the following host names on the command line +to the IPv4 namespace. +


    -


    -Next: , -Previous: sntp ipv4, -Up: sntp Invocation - +
    +

    +Next: , Previous: , Up: sntp Invocation  

    - -

    ipv6 option (-6)

    - -

    -This is the “force ipv6 dns name resolution” option. - -

    This option has some usage constraints. It: -

      -
    • must not appear in combination with any of the following options: -ipv4. -
    - -

    Force DNS resolution of the following host names on the command line -to the IPv6 namespace. -

    + +

    1.1.3 ipv6 option (-6)

    + + +

    This is the “force ipv6 dns name resolution” option. +

    +

    This option has some usage constraints. It: +

      +
    • must not appear in combination with any of the following options: +ipv4. +
    + +

    Force DNS resolution of the following host names on the command line +to the IPv6 namespace. +


    -


    -Next: , -Previous: sntp ipv6, -Up: sntp Invocation - +
    +

    +Next: , Previous: , Up: sntp Invocation  

    - -

    authentication option (-a)

    - -

    -This is the “enable authentication with the key auth-keynumber” option. -This option takes a number argument auth-keynumber. -Enable authentication using the key specified in this option's -argument. The argument of this option is the keyid, a -number specified in the keyfile as this key's identifier. -See the keyfile option (-k) for more details. -

    + +

    1.1.4 authentication option (-a)

    + + +

    This is the “enable authentication with the key auth-keynumber” option. +This option takes a number argument auth-keynumber. +Enable authentication using the key specified in this option’s +argument. The argument of this option is the keyid, a +number specified in the keyfile as this key’s identifier. +See the keyfile option (-k) for more details. +


    -


    -Next: , -Previous: sntp authentication, -Up: sntp Invocation - + - -

    broadcast option (-b)

    - -

    -This is the “listen to the address specified for broadcast time sync” option. -This option takes a string argument broadcast-address. - -

    This option has some usage constraints. It: -

      -
    • may appear an unlimited number of times. -
    - -

    If specified sntp will listen to the specified address + +

    1.1.5 broadcast option (-b)

    + + +

    This is the “listen to the address specified for broadcast time sync” option. +This option takes a string argument broadcast-address. +

    +

    This option has some usage constraints. It: +

      +
    • may appear an unlimited number of times. +
    + +

    If specified sntp will listen to the specified address for NTP broadcasts. The default maximum wait time -can (and probably should) be modified with -t. -

    +can (and probably should) be modified with -t. +


    -


    -Next: , -Previous: sntp broadcast, -Up: sntp Invocation - +
    +

    +Next: , Previous: , Up: sntp Invocation  

    - -

    concurrent option (-c)

    - -

    -This is the “concurrently query all ips returned for host-name” option. -This option takes a string argument host-name. - -

    This option has some usage constraints. It: -

      -
    • may appear an unlimited number of times. -
    - -

    Requests from an NTP "client" to a "server" should never be sent + +

    1.1.6 concurrent option (-c)

    + + +

    This is the “concurrently query all ips returned for host-name” option. +This option takes a string argument host-name. +

    +

    This option has some usage constraints. It: +

      +
    • may appear an unlimited number of times. +
    + +

    Requests from an NTP "client" to a "server" should never be sent more rapidly than one every 2 seconds. By default, any IPs returned as part of a DNS lookup are assumed to be for a single instance of ntpd, and therefore sntp will send queries to these IPs one after another, with a 2-second gap in between each query. - -

    The -c or --concurrent flag says that any IPs +

    +

    The -c or --concurrent flag says that any IPs returned for the DNS lookup of the supplied host-name are on -different machines, so we can send concurrent queries. -

    +different machines, so we can send concurrent queries. +


    -


    -Next: , -Previous: sntp concurrent, -Up: sntp Invocation - +
    +

    +Next: , Previous: , Up: sntp Invocation  

    + +

    1.1.7 gap option (-g)

    + -

    gap option (-g)

    - -

    -This is the “the gap (in milliseconds) between time requests” option. -This option takes a number argument milliseconds. -Since we're only going to use the first valid response we get and +

    This is the “the gap (in milliseconds) between time requests” option. +This option takes a number argument milliseconds. +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. -

    +milliseconds. +


    -


    -Next: , -Previous: sntp gap, -Up: sntp Invocation - +
    +

    +Next: , Previous: , Up: sntp Invocation  

    + +

    1.1.8 kod option (-K)

    + -

    kod option (-K)

    - -

    -This is the “kod history filename” option. -This option takes a file argument file-name. +

    This is the “kod history filename” option. +This option takes a file argument file-name. 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. -

    +warning message will be displayed. The file will not be created. +


    -


    -Next: , -Previous: sntp kod, -Up: sntp Invocation - +
    +

    +Next: , Previous: , Up: sntp Invocation  

    - -

    keyfile option (-k)

    - -

    -This is the “look in this file for the key specified with -a” option. -This option takes a file argument file-name. -This option specifies the keyfile. -sntp will search for the key specified with -a -keyno in this file. See ntp.keys(5) for more -information. -

    + +

    1.1.9 keyfile option (-k)

    + + +

    This is the “look in this file for the key specified with -a” option. +This option takes a file argument file-name. +This option specifies the keyfile. +sntp will search for the key specified with -a +keyno in this file. See ntp.keys(5) for more +information. +


    -


    -Next: , -Previous: sntp keyfile, -Up: sntp Invocation - +
    +

    +Next: , Previous: , Up: sntp Invocation  

    + +

    1.1.10 logfile option (-l)

    + -

    logfile option (-l)

    - -

    -This is the “log to specified logfile” option. -This option takes a file argument file-name. +

    This is the “log to specified logfile” option. +This option takes a file argument file-name. This option causes the client to write log messages to the specified -logfile. -

    +logfile. +


    -


    -Next: , -Previous: sntp logfile, -Up: sntp Invocation - +
    +

    +Next: , Previous: , Up: sntp Invocation  

    - -

    steplimit option (-M)

    - -

    -This is the “adjustments less than steplimit msec will be slewed” option. -This option takes a number argument. -If the time adjustment is less than steplimit milliseconds, -slew the amount using adjtime(2). Otherwise, step the -correction using settimeofday(2). The default value is 0, + +

    1.1.11 steplimit option (-M)

    + + +

    This is the “adjustments less than steplimit msec will be slewed” option. +This option takes a number argument. +If the time adjustment is less than steplimit milliseconds, +slew the amount using adjtime(2). Otherwise, step the +correction using settimeofday(2). The default value is 0, which means all adjustments will be stepped. This is a feature, as -different situations demand different values. -

    +different situations demand different values. +


    -


    -Next: , -Previous: sntp steplimit, -Up: sntp Invocation - + + +

    1.1.12 ntpversion option (-o)

    + -

    ntpversion option (-o)

    - -

    -This is the “send int as our ntp protocol version” option. -This option takes a number argument. +

    This is the “send int 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 ntpversion . -

    +NTP protocol version ntpversion . +


    -


    -Next: , -Previous: sntp ntpversion, -Up: sntp Invocation - +
    +

    +Next: , Previous: , Up: sntp Invocation  

    + +

    1.1.13 usereservedport option (-r)

    + -

    usereservedport option (-r)

    - -

    -This is the “use the ntp reserved port (port 123)” option. +

    This is the “use the ntp reserved port (port 123)” option. Use port 123, which is reserved for NTP, for our network -communications. -

    +communications. +


    -


    -Next: , -Previous: sntp usereservedport, -Up: sntp Invocation - +
    +

    +Next: , Previous: , Up: sntp Invocation  

    + +

    1.1.14 timeout option (-t)

    + -

    timeout option (-t)

    - -

    -This is the “the number of seconds to wait for responses” option. -This option takes a number argument seconds. +

    This is the “the number of seconds to wait for responses” option. +This option takes a number argument seconds. When waiting for a reply, sntp will wait the number of seconds specified before giving up. The default should be more than enough for a unicast response. If sntp is only waiting for a broadcast response a longer timeout is -likely needed. -

    +likely needed. +


    -


    -Next: , -Previous: sntp timeout, -Up: sntp Invocation - +
    +

    +Next: , Previous: , Up: sntp Invocation  

    - -

    wait option

    - -

    -This is the “wait for pending replies (if not setting the time)” option. - -

    This option has some usage constraints. It: -

      -
    • can be disabled with –no-wait. -
    • It is enabled by default. -
    - -

    If we are not setting the time, wait for all pending responses. - -

    + +

    1.1.15 wait option

    + + +

    This is the “wait for pending replies (if not setting the time)” option. +

    +

    This option has some usage constraints. It: +

      +
    • can be disabled with –no-wait. +
    • It is enabled by default. +
    + +

    If we are not setting the time, wait for all pending responses. +

    + +
    -


    -Next: , -Previous: sntp wait, -Up: sntp Invocation - +
    +

    +Next: , Previous: , Up: sntp Invocation  

    - -

    presetting/configuring sntp

    + +

    1.1.16 presetting/configuring sntp

    Any option that is not marked as not presettable may be preset by -loading values from configuration ("rc" or "ini") files, and values from environment variables named SNTP and SNTP_<OPTION_NAME>. <OPTION_NAME> 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 SNTP and SNTP_<OPTION_NAME>. <OPTION_NAME> must be one of +the options listed above in upper case and segmented with underscores. The SNTP 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. - -

    libopts will search in 2 places for configuration files: -

      -
    • $HOME -
    • $PWD -
    - The environment variables HOME, and PWD -are expanded and replaced when sntp runs. -For any of these that are plain files, they are simply processed. -For any that are directories, then a file named .ntprc is searched for +

    + +

    libopts will search in 2 places for configuration files: +

      +
    • $HOME +
    • $PWD +
    +

    The environment variables HOME, and PWD +are expanded and replaced when sntp runs. +For any of these that are plain files, they are simply processed. +For any that are directories, then a file named .ntprc is searched for within that directory and processed. - -

    Configuration files may be in a wide variety of formats. +

    +

    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. - -

    Multiple programs may also share the same initialization file. +

    +

    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: -

        [SNTP]
    -
    -

    or by -

        <?program sntp>
    -
    -

    Do not mix these styles within one configuration file. - -

    Compound values and carefully constructed string values may also be +

    +
    [SNTP]
    +
    +

    or by +

    +
    <?program sntp>
    +
    +

    Do not mix these styles within one configuration file. +

    +

    Compound values and carefully constructed string values may also be specified using XML syntax: -

        <option-name>
    -       <sub-opt>...&lt;...&gt;...</sub-opt>
    -    </option-name>
    -
    -

    yielding an option-name.sub-opt string value of -

        "...<...>..."
    -
    -

    AutoOpts does not track suboptions. You simply note that it is a +

    +
    <option-name>
    +   <sub-opt>...&lt;...&gt;...</sub-opt>
    +</option-name>
    +
    +

    yielding an option-name.sub-opt string value of +

    +
    "...<...>..."
    +
    +

    AutoOpts does not track suboptions. You simply note that it is a hierarchicly valued option. AutoOpts does provide a means for searching the associated name/value pair list (see: optionFindValue). - -

    The command line options relating to configuration and/or usage help are: - -

    version (-)
    +

    +

    The command line options relating to configuration and/or usage help are: +

    + +

    version (-)

    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: - -

    -
    version
    Only print the version. This is the default. -
    copyright
    Name the copyright usage licensing terms. -
    verbose
    Print the full copyright usage licensing terms. +

    +
    +
    version
    +

    Only print the version. This is the default. +

    +
    copyright
    +

    Name the copyright usage licensing terms. +

    +
    verbose
    +

    Print the full copyright usage licensing terms. +

    -
    +
    -


    -Next: , -Previous: sntp config, -Up: sntp Invocation - +
    +

    +Next: , Previous: , Up: sntp Invocation  

    - -

    sntp exit status

    + +

    1.1.17 sntp exit status

    One of the following exit values will be returned: -

    -
    0 (EXIT_SUCCESS)
    Successful program execution. -
    1 (EXIT_FAILURE)
    The operation failed or the command syntax was not valid. -
    66 (EX_NOINPUT)
    A specified configuration file could not be loaded. -
    70 (EX_SOFTWARE)
    libopts had an internal operational error. Please report -it to autogen-users@lists.sourceforge.net. Thank you. +

    +
    0 (EXIT_SUCCESS)
    +

    Successful program execution. +

    +
    1 (EXIT_FAILURE)
    +

    The operation failed or the command syntax was not valid. +

    +
    66 (EX_NOINPUT)
    +

    A specified configuration file could not be loaded. +

    +
    70 (EX_SOFTWARE)
    +

    libopts had an internal operational error. Please report +it to autogen-users@lists.sourceforge.net. Thank you. +

    -
    +
    -


    -Next: , -Previous: sntp exit status, -Up: sntp Invocation - +
    +

    +Next: , Previous: , Up: sntp Invocation  

    - -

    sntp Usage

    - -
    + +

    1.1.18 sntp Usage

    +
    -


    -Previous: sntp Usage, -Up: sntp Invocation - +
    +

    +Previous: , Up: sntp Invocation  

    + +

    1.1.19 sntp Authors

    -

    sntp Authors

    - -
    +
    -


    - - +
    +

    +Previous: , Up: sntp Description  

    - - -

    Usage

    + +

    1.2 Usage

    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: +

    +
    +
    sntp ntpserver.somewhere
    +
    -
        sntp ntpserver.somewhere
    -
    -

    With suitable privilege, it can be run as a command or in a +

    With suitable privilege, it can be run as a command or in a crom job to reset the local clock from a reliable server, like -the ntpdate and rdate commands. +the ntpdate and rdate commands. For example: +

    +
    +
    sntp -a ntpserver.somewhere
    +
    +
    + -
        sntp -a ntpserver.somewhere
    -
    - + + diff --git a/sntp/sntp.man.in b/sntp/sntp.man.in index e37c98f53..60acc9700 100644 --- a/sntp/sntp.man.in +++ b/sntp/sntp.man.in @@ -10,11 +10,11 @@ .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 diff --git a/sntp/sntp.mdoc.in b/sntp/sntp.mdoc.in index 7cd430965..b30d324cd 100644 --- a/sntp/sntp.mdoc.in +++ b/sntp/sntp.mdoc.in @@ -1,9 +1,9 @@ -.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 diff --git a/util/invoke-ntp-keygen.texi b/util/invoke-ntp-keygen.texi index f83ff36b4..3c94b708a 100644 --- a/util/invoke-ntp-keygen.texi +++ b/util/invoke-ntp-keygen.texi @@ -6,7 +6,7 @@ # # 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 diff --git a/util/ntp-keygen-opts.c b/util/ntp-keygen-opts.c index 6ddb16493..f9c06775b 100644 --- a/util/ntp-keygen-opts.c +++ b/util/ntp-keygen-opts.c @@ -1,11 +1,11 @@ /* * 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 diff --git a/util/ntp-keygen-opts.h b/util/ntp-keygen-opts.h index a3d55aeb6..a04127416 100644 --- a/util/ntp-keygen-opts.h +++ b/util/ntp-keygen-opts.h @@ -1,11 +1,11 @@ /* * 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 @@ -53,7 +53,7 @@ * 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 diff --git a/util/ntp-keygen.1ntp-keygenman b/util/ntp-keygen.1ntp-keygenman index b22ae94d4..926b391bb 100644 --- a/util/ntp-keygen.1ntp-keygenman +++ b/util/ntp-keygen.1ntp-keygenman @@ -10,11 +10,11 @@ .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 diff --git a/util/ntp-keygen.1ntp-keygenmdoc b/util/ntp-keygen.1ntp-keygenmdoc index 5b96c92be..be4c089f4 100644 --- a/util/ntp-keygen.1ntp-keygenmdoc +++ b/util/ntp-keygen.1ntp-keygenmdoc @@ -1,9 +1,9 @@ -.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 diff --git a/util/ntp-keygen.html b/util/ntp-keygen.html index dcb271349..597969912 100644 --- a/util/ntp-keygen.html +++ b/util/ntp-keygen.html @@ -1405,7 +1405,7 @@ used to select the program, defaulting to more. Both will exit with a status code of 0.

    -
    ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.8p13
    +
    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
    diff --git a/util/ntp-keygen.man.in b/util/ntp-keygen.man.in
    index 8a2b1fe0f..25c12e4ac 100644
    --- a/util/ntp-keygen.man.in
    +++ b/util/ntp-keygen.man.in
    @@ -10,11 +10,11 @@
     .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
    diff --git a/util/ntp-keygen.mdoc.in b/util/ntp-keygen.mdoc.in
    index 64289168b..af0d6cbae 100644
    --- a/util/ntp-keygen.mdoc.in
    +++ b/util/ntp-keygen.mdoc.in
    @@ -1,9 +1,9 @@
    -.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