diff options
| author | Cy Schubert <cy@FreeBSD.org> | 2019-03-07 13:36:00 +0000 |
|---|---|---|
| committer | Cy Schubert <cy@FreeBSD.org> | 2019-03-07 13:36:00 +0000 |
| commit | 052d159a8b83f03d7dc5eb31cd9a9b4a6fe3d9da (patch) | |
| tree | f2dd8b09036f9c701fb0d5b71209a9ff8dea7712 /contrib/ntp/scripts | |
| parent | 16b56c7f4ee6ec20040f485b2774a4ca4ae6e62c (diff) | |
| parent | 360c01464aee3bc4c520898a675f35967db09ac2 (diff) | |
| download | src-052d159a8b83f03d7dc5eb31cd9a9b4a6fe3d9da.tar.gz src-052d159a8b83f03d7dc5eb31cd9a9b4a6fe3d9da.zip | |
MFV r344878:
4.2.8p12 --> 4.2.8p13
MFC after: immediately
Security: CVE-2019-8936
VuXML: c2576e14-36e2-11e9-9eda-206a8a720317
Obtained from: nwtime.org
Notes
Notes:
svn path=/head/; revision=344883
Diffstat (limited to 'contrib/ntp/scripts')
57 files changed, 1539 insertions, 1162 deletions
diff --git a/contrib/ntp/scripts/Makefile.in b/contrib/ntp/scripts/Makefile.in index f185b9dd7032..1725b151bb64 100644 --- a/contrib/ntp/scripts/Makefile.in +++ b/contrib/ntp/scripts/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.15 from Makefile.am. +# Makefile.in generated by automake 1.15.1 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2014 Free Software Foundation, Inc. +# Copyright (C) 1994-2017 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, diff --git a/contrib/ntp/scripts/build/Makefile.in b/contrib/ntp/scripts/build/Makefile.in index eb5d28c25f93..44718a830ff9 100644 --- a/contrib/ntp/scripts/build/Makefile.in +++ b/contrib/ntp/scripts/build/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.15 from Makefile.am. +# Makefile.in generated by automake 1.15.1 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2014 Free Software Foundation, Inc. +# Copyright (C) 1994-2017 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, diff --git a/contrib/ntp/scripts/build/check--help b/contrib/ntp/scripts/build/check--help index 1524675b4473..a968fc4ecabf 100755 --- a/contrib/ntp/scripts/build/check--help +++ b/contrib/ntp/scripts/build/check--help @@ -10,13 +10,13 @@ if test ! -f $1 then - echo "$0: $1 is not a regular file!" 2>&3 + echo "$0: $1 is not a regular file!" 1>&2 exit 1 fi if grep -q 'no --help' $1 then - echo "$0: $1 contains 'no --help'!" 2>&3 + echo "$0: $1 contains 'no --help'!" 1>&2 mv ${1} ${1}- exit 1 fi diff --git a/contrib/ntp/scripts/calc_tickadj/Makefile.in b/contrib/ntp/scripts/calc_tickadj/Makefile.in index cd49b6898609..106f368af795 100644 --- a/contrib/ntp/scripts/calc_tickadj/Makefile.in +++ b/contrib/ntp/scripts/calc_tickadj/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.15 from Makefile.am. +# Makefile.in generated by automake 1.15.1 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2014 Free Software Foundation, Inc. +# Copyright (C) 1994-2017 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, diff --git a/contrib/ntp/scripts/calc_tickadj/calc_tickadj.1calc_tickadjman b/contrib/ntp/scripts/calc_tickadj/calc_tickadj.1calc_tickadjman index 8fa228e8a13f..14db08ae8b26 100644 --- a/contrib/ntp/scripts/calc_tickadj/calc_tickadj.1calc_tickadjman +++ b/contrib/ntp/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 "14 Aug 2018" "ntp (4.2.8p12)" "User Commands" +.TH calc_tickadj 1calc_tickadjman "20 Feb 2019" "ntp (4.2.8p13)" "User Commands" .\" -.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-98aG9a/ag-j9aG8a) +.\" EDIT THIS FILE WITH CAUTION (in-mem file) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:08:53 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 09:57:23 AM by AutoGen 5.18.5 .\" From the definitions calc_tickadj-opts.def .\" and the template file agman-cmd.tpl .SH NAME diff --git a/contrib/ntp/scripts/calc_tickadj/calc_tickadj.1calc_tickadjmdoc b/contrib/ntp/scripts/calc_tickadj/calc_tickadj.1calc_tickadjmdoc index 467f1e8e2266..dff96f4b6273 100644 --- a/contrib/ntp/scripts/calc_tickadj/calc_tickadj.1calc_tickadjmdoc +++ b/contrib/ntp/scripts/calc_tickadj/calc_tickadj.1calc_tickadjmdoc @@ -1,9 +1,9 @@ -.Dd August 14 2018 +.Dd February 20 2019 .Dt CALC_TICKADJ 1calc_tickadjmdoc User Commands .Os .\" EDIT THIS FILE WITH CAUTION (calc_tickadj-opts.mdoc) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:08:56 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 09:57:24 AM by AutoGen 5.18.5 .\" From the definitions calc_tickadj-opts.def .\" and the template file agmdoc-cmd.tpl .Sh NAME diff --git a/contrib/ntp/scripts/calc_tickadj/calc_tickadj.html b/contrib/ntp/scripts/calc_tickadj/calc_tickadj.html index baba8c71883b..3f65c4948359 100644 --- a/contrib/ntp/scripts/calc_tickadj/calc_tickadj.html +++ b/contrib/ntp/scripts/calc_tickadj/calc_tickadj.html @@ -1,115 +1,156 @@ -<html lang="en"> +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ --> <head> -<title>calc_tickadj User's Manual</title> -<meta http-equiv="Content-Type" content="text/html"> -<meta name="description" content="calc_tickadj User's Manual"> -<meta name="generator" content="makeinfo 4.7"> -<link title="Top" rel="top" href="#Top"> -<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> -<meta http-equiv="Content-Style-Type" content="text/css"> -<style type="text/css"><!-- - pre.display { font-family:inherit } - pre.format { font-family:inherit } - pre.smalldisplay { font-family:inherit; font-size:smaller } - pre.smallformat { font-family:inherit; font-size:smaller } - pre.smallexample { font-size:smaller } - pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } ---></style> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>calc_tickadj User’s Manual</title> + +<meta name="description" content="calc_tickadj User’s Manual"> +<meta name="keywords" content="calc_tickadj User’s Manual"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<link href="#Top" rel="start" title="Top"> +<link href="dir.html#Top" rel="up" title="(dir)"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +blockquote.smallindentedblock {margin-right: 0em; font-size: smaller} +blockquote.smallquotation {font-size: smaller} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +div.smalldisplay {margin-left: 3.2em} +div.smallexample {margin-left: 3.2em} +div.smalllisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +pre.smalldisplay {font-family: inherit; font-size: smaller} +pre.smallexample {font-size: smaller} +pre.smallformat {font-family: inherit; font-size: smaller} +pre.smalllisp {font-size: smaller} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + + </head> -<body> -<h1 class="settitle">calc_tickadj User's Manual</h1> -<div class="node"> -<p><hr> -<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#calc_005ftickadj-Description">calc_tickadj Description</a>, -Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>, -Up: <a rel="up" accesskey="u" href="#dir">(dir)</a> -<br> -</div> -<h2 class="unnumbered">calc_tickadj User's Manual</h2> +<body lang="en"> +<h1 class="settitle" align="center">calc_tickadj User’s Manual</h1> -<p>This document describes the use of the NTP Project's <code>calc_tickadj</code> program. -This document applies to version 4.2.8p12 of <code>calc_tickadj</code>. - <div class="shortcontents"> -<h2>Short Contents</h2> -<ul> -<a href="#Top">calc_tickadj User's Manual</a> + + +<a name="Top"></a> +<div class="header"> +<p> +Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> </p> +</div> +<a name="calc_005ftickadj-User_0027s-Manual"></a> +<h1 class="top">calc_tickadj User’s Manual</h1> + +<p>This document describes the use of the NTP Project’s <code>calc_tickadj</code> program. +This document applies to version 4.2.8p13 of <code>calc_tickadj</code>. +</p> +<a name="SEC_Overview"></a> +<h2 class="shortcontents-heading">Short Table of Contents</h2> + +<div class="shortcontents"> +<ul class="no-bullet"> +<li><a name="stoc-Invoking-calc_005ftickadj" href="#toc-Invoking-calc_005ftickadj">1 Invoking calc_tickadj</a></li> </ul> </div> -<ul class="menu"> -<li><a accesskey="1" href="#calc_005ftickadj-Description">calc_tickadj Description</a>: Description -<li><a accesskey="2" href="#calc_005ftickadj-Invocation">calc_tickadj Invocation</a>: Invoking calc_tickadj -</ul> -<div class="node"> -<p><hr> -<a name="calc_005ftickadj-Invocation"></a>Previous: <a rel="previous" accesskey="p" href="#calc_005ftickadj-Description">calc_tickadj Description</a>, -Up: <a rel="up" accesskey="u" href="#Top">Top</a> -<br> -</div> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• calc_tickadj Description:</td><td> </td><td align="left" valign="top">Description +</td></tr> +<tr><td align="left" valign="top">• <a href="#calc_005ftickadj-Invocation" accesskey="2">calc_tickadj Invocation</a>:</td><td> </td><td align="left" valign="top">Invoking calc_tickadj +</td></tr> +</table> -<h3 class="section">Invoking calc_tickadj</h3> +<hr> +<a name="calc_005ftickadj-Invocation"></a> +<div class="header"> +<p> +Up: <a href="#Top" accesskey="u" rel="up">Top</a> </p> +</div> +<a name="Invoking-calc_005ftickadj"></a> +<h2 class="chapter">1 Invoking calc_tickadj</h2> +<a name="index-calc_005ftickadj"></a> +<a name="index-Calculates-_0022optimal_0022-value-for-tick-given-ntp-drift-file_002e"></a> -<p><a name="index-calc_005ftickadj-1"></a><a name="index-Calculates-_0022optimal_0022-value-for-tick-given-ntp-drift-file_002e-2"></a> -The <code>calc_tickadj</code> script uses provided ntp drift file to generate optimal +<p>The <code>calc_tickadj</code> script uses provided ntp drift file to generate optimal tick value. Generally, ntpd can do better job if the drift value is the -smallest possible number. - - <p>The example output of -<pre class="example"> $ ./calc_tickadj - 81.699 (drift) - 9999 usec; 9999779 nsec - $ cat /etc/ntp/drift - -23.159 -</pre> - <p>means the following. If tick on that box is 10,000, by making the value 9999 -we'll shift the box from its current drift of -23.159 to a drift of 81.699, and -in doing so we'll speed the clock up a little every second instead of slowing +smallest possible number. +</p> +<p>The example output of +</p><div class="example"> +<pre class="example">$ ./calc_tickadj +81.699 (drift) +9999 usec; 9999779 nsec +$ cat /etc/ntp/drift +-23.159 +</pre></div> + +<p>means the following. If tick on that box is 10,000, by making the value 9999 +we’ll shift the box from its current drift of -23.159 to a drift of 81.699, and +in doing so we’ll speed the clock up a little every second instead of slowing the clock down a little. - - <p>If 'tick' on that box is 10,000,000 then by setting it to 9999779 the drift +</p> +<p>If ’tick’ on that box is 10,000,000 then by setting it to 9999779 the drift value will be somewhere around 0.0. - - <p><code>calc_tickadj</code> tries to determine the the tick value by using -<code>tickadj</code> program from ntp package. If this doesn't work you can specify +</p> +<p><code>calc_tickadj</code> tries to determine the the tick value by using +<code>tickadj</code> program from ntp package. If this doesn’t work you can specify current tick manually on command line. +</p> - <p>This section was generated by <strong>AutoGen</strong>, +<p>This section was generated by <strong>AutoGen</strong>, using the <code>agtexi-cmd</code> template and the option descriptions for the <code>calc_tickadj</code> program. - -<ul class="menu"> -<li><a accesskey="1" href="#calc_005ftickadj-usage">calc_tickadj usage</a>: calc_tickadj help/usage (<span class="option">--help</span>) -<li><a accesskey="2" href="#calc_005ftickadj-drift_002dfile">calc_tickadj drift-file</a>: drift-file option (-d) -<li><a accesskey="3" href="#calc_005ftickadj-tick">calc_tickadj tick</a>: tick option (-t) -<li><a accesskey="4" href="#calc_005ftickadj-exit-status">calc_tickadj exit status</a>: exit status -</ul> - -<div class="node"> -<p><hr> -<a name="calc_005ftickadj-usage"></a>Next: <a rel="next" accesskey="n" href="#calc_005ftickadj-drift_002dfile">calc_tickadj drift-file</a>, -Up: <a rel="up" accesskey="u" href="#calc_005ftickadj-Invocation">calc_tickadj Invocation</a> -<br> +</p> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#calc_005ftickadj-usage" accesskey="1">calc_tickadj usage</a>:</td><td> </td><td align="left" valign="top">calc_tickadj help/usage (<samp>--help</samp>) +</td></tr> +<tr><td align="left" valign="top">• <a href="#calc_005ftickadj-drift_002dfile" accesskey="2">calc_tickadj drift-file</a>:</td><td> </td><td align="left" valign="top">drift-file option (-d) +</td></tr> +<tr><td align="left" valign="top">• <a href="#calc_005ftickadj-tick" accesskey="3">calc_tickadj tick</a>:</td><td> </td><td align="left" valign="top">tick option (-t) +</td></tr> +<tr><td align="left" valign="top">• <a href="#calc_005ftickadj-exit-status" accesskey="4">calc_tickadj exit status</a>:</td><td> </td><td align="left" valign="top">exit status +</td></tr> +</table> + +<hr> +<a name="calc_005ftickadj-usage"></a> +<div class="header"> +<p> +Next: <a href="#calc_005ftickadj-drift_002dfile" accesskey="n" rel="next">calc_tickadj drift-file</a>, Up: <a href="#calc_005ftickadj-Invocation" accesskey="u" rel="up">calc_tickadj Invocation</a> </p> </div> - -<h4 class="subsection">calc_tickadj help/usage (<span class="option">--help</span>)</h4> - -<p><a name="index-calc_005ftickadj-help-3"></a> -This is the automatically generated usage text for calc_tickadj. - - <p>The text printed is the same whether selected with the <code>help</code> option -(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print -the usage text by passing it through a pager program. +<a name="calc_005ftickadj-help_002fusage-_0028_002d_002dhelp_0029"></a> +<h3 class="section">1.1 calc_tickadj help/usage (<samp>--help</samp>)</h3> +<a name="index-calc_005ftickadj-help"></a> + +<p>This is the automatically generated usage text for calc_tickadj. +</p> +<p>The text printed is the same whether selected with the <code>help</code> option +(<samp>--help</samp>) or the <code>more-help</code> option (<samp>--more-help</samp>). <code>more-help</code> will print +the usage text by passing it through a pager program. <code>more-help</code> is disabled on platforms without a working <code>fork(2)</code> function. The <code>PAGER</code> environment variable is -used to select the program, defaulting to <span class="file">more</span>. Both will exit +used to select the program, defaulting to <samp>more</samp>. Both will exit with a status code of 0. - -<pre class="example">calc_tickadj - Calculates "optimal" value for tick given ntp drift file. - Ver. 4.2.7p467 -USAGE: calc_tickadj [ -<flag> [<val>] | --<name>[{=| }<val>] ]... +</p> +<div class="example"> +<pre class="example">calc_tickadj - Calculates "optimal" value for tick given ntp drift file. - Ver. 4.2.7p467 +USAGE: calc_tickadj [ -<flag> [<val>] | --<name>[{=| }<val>] ]... -d, --drift-file=str Ntp drift file to use -t, --tick=num Tick value of this host @@ -118,49 +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. -</pre> - <div class="node"> -<p><hr> -<a name="calc_005ftickadj-drift_002dfile"></a>Next: <a rel="next" accesskey="n" href="#calc_005ftickadj-tick">calc_tickadj tick</a>, -Previous: <a rel="previous" accesskey="p" href="#calc_005ftickadj-usage">calc_tickadj usage</a>, -Up: <a rel="up" accesskey="u" href="#calc_005ftickadj-Invocation">calc_tickadj Invocation</a> -<br> +</pre></div> + +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#calc_005ftickadj-drift_002dfile" accesskey="1">calc_tickadj drift-file</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#calc_005ftickadj-tick" accesskey="2">calc_tickadj tick</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#calc_005ftickadj-exit-status" accesskey="3">calc_tickadj exit status</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +</table> + +<hr> +<a name="calc_005ftickadj-drift_002dfile"></a> +<div class="header"> +<p> +Next: <a href="#calc_005ftickadj-tick" accesskey="n" rel="next">calc_tickadj tick</a>, Previous: <a href="#calc_005ftickadj-usage" accesskey="p" rel="prev">calc_tickadj usage</a>, Up: <a href="#calc_005ftickadj-usage" accesskey="u" rel="up">calc_tickadj usage</a> </p> </div> +<a name="drift_002dfile-option-_0028_002dd_0029"></a> +<h4 class="subsection">1.1.1 drift-file option (-d)</h4> +<a name="index-calc_005ftickadj_002ddrift_002dfile"></a> -<h4 class="subsection">drift-file option (-d)</h4> - -<p><a name="index-calc_005ftickadj_002ddrift_002dfile-4"></a> -This is the “ntp drift file to use” option. -This option takes a string argument. +<p>This is the “ntp drift file to use” option. +This option takes a string argument. Use the specified drift file for calculations -<div class="node"> -<p><hr> -<a name="calc_005ftickadj-tick"></a>Next: <a rel="next" accesskey="n" href="#calc_005ftickadj-exit-status">calc_tickadj exit status</a>, -Previous: <a rel="previous" accesskey="p" href="#calc_005ftickadj-drift_002dfile">calc_tickadj drift-file</a>, -Up: <a rel="up" accesskey="u" href="#calc_005ftickadj-Invocation">calc_tickadj Invocation</a> -<br> +</p><hr> +<a name="calc_005ftickadj-tick"></a> +<div class="header"> +<p> +Next: <a href="#calc_005ftickadj-exit-status" accesskey="n" rel="next">calc_tickadj exit status</a>, Previous: <a href="#calc_005ftickadj-drift_002dfile" accesskey="p" rel="prev">calc_tickadj drift-file</a>, Up: <a href="#calc_005ftickadj-usage" accesskey="u" rel="up">calc_tickadj usage</a> </p> </div> +<a name="tick-option-_0028_002dt_0029"></a> +<h4 class="subsection">1.1.2 tick option (-t)</h4> +<a name="index-calc_005ftickadj_002dtick"></a> -<h4 class="subsection">tick option (-t)</h4> - -<p><a name="index-calc_005ftickadj_002dtick-5"></a> -This is the “tick value of this host” option. -This option takes a number argument. +<p>This is the “tick value of this host” option. +This option takes a number argument. The current tick which to adjustment will be calculated -<div class="node"> -<p><hr> -<a name="calc_005ftickadj-exit-status"></a>Previous: <a rel="previous" accesskey="p" href="#calc_005ftickadj-tick">calc_tickadj tick</a>, -Up: <a rel="up" accesskey="u" href="#calc_005ftickadj-Invocation">calc_tickadj Invocation</a> -<br> +</p><hr> +<a name="calc_005ftickadj-exit-status"></a> +<div class="header"> +<p> +Previous: <a href="#calc_005ftickadj-tick" accesskey="p" rel="prev">calc_tickadj tick</a>, Up: <a href="#calc_005ftickadj-usage" accesskey="u" rel="up">calc_tickadj usage</a> </p> </div> - -<h4 class="subsection">calc_tickadj exit status</h4> +<a name="calc_005ftickadj-exit-status-1"></a> +<h4 class="subsection">1.1.3 calc_tickadj exit status</h4> <p>One of the following exit values will be returned: - <dl> -<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution. -<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid. +</p><dl compact="compact"> +<dt>‘<samp>0 (EXIT_SUCCESS)</samp>’</dt> +<dd><p>Successful program execution. +</p></dd> +<dt>‘<samp>1 (EXIT_FAILURE)</samp>’</dt> +<dd><p>The operation failed or the command syntax was not valid. +</p></dd> </dl> +<hr> + -</body></html> +</body> +</html> diff --git a/contrib/ntp/scripts/calc_tickadj/calc_tickadj.man.in b/contrib/ntp/scripts/calc_tickadj/calc_tickadj.man.in index 8fa228e8a13f..14db08ae8b26 100644 --- a/contrib/ntp/scripts/calc_tickadj/calc_tickadj.man.in +++ b/contrib/ntp/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 "14 Aug 2018" "ntp (4.2.8p12)" "User Commands" +.TH calc_tickadj 1calc_tickadjman "20 Feb 2019" "ntp (4.2.8p13)" "User Commands" .\" -.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-98aG9a/ag-j9aG8a) +.\" EDIT THIS FILE WITH CAUTION (in-mem file) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:08:53 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 09:57:23 AM by AutoGen 5.18.5 .\" From the definitions calc_tickadj-opts.def .\" and the template file agman-cmd.tpl .SH NAME diff --git a/contrib/ntp/scripts/calc_tickadj/calc_tickadj.mdoc.in b/contrib/ntp/scripts/calc_tickadj/calc_tickadj.mdoc.in index 467f1e8e2266..dff96f4b6273 100644 --- a/contrib/ntp/scripts/calc_tickadj/calc_tickadj.mdoc.in +++ b/contrib/ntp/scripts/calc_tickadj/calc_tickadj.mdoc.in @@ -1,9 +1,9 @@ -.Dd August 14 2018 +.Dd February 20 2019 .Dt CALC_TICKADJ 1calc_tickadjmdoc User Commands .Os .\" EDIT THIS FILE WITH CAUTION (calc_tickadj-opts.mdoc) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:08:56 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 09:57:24 AM by AutoGen 5.18.5 .\" From the definitions calc_tickadj-opts.def .\" and the template file agmdoc-cmd.tpl .Sh NAME diff --git a/contrib/ntp/scripts/calc_tickadj/invoke-calc_tickadj.texi b/contrib/ntp/scripts/calc_tickadj/invoke-calc_tickadj.texi index e88fea882dc2..65c738d31dbf 100644 --- a/contrib/ntp/scripts/calc_tickadj/invoke-calc_tickadj.texi +++ b/contrib/ntp/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 August 14, 2018 at 08:08:59 AM by AutoGen 5.18.5 +# It has been AutoGen-ed February 20, 2019 at 09:57:25 AM by AutoGen 5.18.5 # From the definitions calc_tickadj-opts.def # and the template file agtexi-cmd.tpl @end ignore diff --git a/contrib/ntp/scripts/invoke-plot_summary.texi b/contrib/ntp/scripts/invoke-plot_summary.texi index d4616e2e946e..f0b904579427 100644 --- a/contrib/ntp/scripts/invoke-plot_summary.texi +++ b/contrib/ntp/scripts/invoke-plot_summary.texi @@ -6,7 +6,7 @@ # # EDIT THIS FILE WITH CAUTION (invoke-plot_summary.texi) # -# It has been AutoGen-ed August 14, 2018 at 08:09:41 AM by AutoGen 5.18.5 +# It has been AutoGen-ed February 20, 2019 at 05:04:25 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.8p12 +plot_summary - plot statistics generated by summary script - Ver. 4.2.8p13 USAGE: plot_summary [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... --directory=str Where the summary files are diff --git a/contrib/ntp/scripts/invoke-summary.texi b/contrib/ntp/scripts/invoke-summary.texi index e39457883a7f..08bf305f0b9f 100644 --- a/contrib/ntp/scripts/invoke-summary.texi +++ b/contrib/ntp/scripts/invoke-summary.texi @@ -6,7 +6,7 @@ # # EDIT THIS FILE WITH CAUTION (invoke-summary.texi) # -# It has been AutoGen-ed August 14, 2018 at 08:09:47 AM by AutoGen 5.18.5 +# It has been AutoGen-ed February 20, 2019 at 05:04:29 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.8p12 +summary - compute various stastics from NTP stat files - Ver. 4.2.8p13 USAGE: summary [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... --directory=str Directory containing stat files diff --git a/contrib/ntp/scripts/lib/Makefile.in b/contrib/ntp/scripts/lib/Makefile.in index 3cafdf815b54..e2750d21034c 100644 --- a/contrib/ntp/scripts/lib/Makefile.in +++ b/contrib/ntp/scripts/lib/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.15 from Makefile.am. +# Makefile.in generated by automake 1.15.1 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2014 Free Software Foundation, Inc. +# Copyright (C) 1994-2017 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, diff --git a/contrib/ntp/scripts/ntp-wait/Makefile.in b/contrib/ntp/scripts/ntp-wait/Makefile.in index 9df58c5f4f4a..5977c52c61b4 100644 --- a/contrib/ntp/scripts/ntp-wait/Makefile.in +++ b/contrib/ntp/scripts/ntp-wait/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.15 from Makefile.am. +# Makefile.in generated by automake 1.15.1 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2014 Free Software Foundation, Inc. +# Copyright (C) 1994-2017 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, diff --git a/contrib/ntp/scripts/ntp-wait/invoke-ntp-wait.texi b/contrib/ntp/scripts/ntp-wait/invoke-ntp-wait.texi index 83bc954d857a..527035a70471 100644 --- a/contrib/ntp/scripts/ntp-wait/invoke-ntp-wait.texi +++ b/contrib/ntp/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 August 14, 2018 at 08:09:07 AM by AutoGen 5.18.5 +# It has been AutoGen-ed February 20, 2019 at 09:57:28 AM 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.8p12 +ntp-wait - Wait for ntpd to stabilize the system clock - Ver. 4.2.8p13 USAGE: ntp-wait [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... -n, --tries=num Number of times to check ntpd diff --git a/contrib/ntp/scripts/ntp-wait/ntp-wait-opts b/contrib/ntp/scripts/ntp-wait/ntp-wait-opts index 47c4c1ac8a05..e81dc0e3da9f 100644 --- a/contrib/ntp/scripts/ntp-wait/ntp-wait-opts +++ b/contrib/ntp/scripts/ntp-wait/ntp-wait-opts @@ -1,6 +1,6 @@ # EDIT THIS FILE WITH CAUTION (ntp-wait-opts) # -# It has been AutoGen-ed August 14, 2018 at 08:09:02 AM by AutoGen 5.18.5 +# It has been AutoGen-ed February 20, 2019 at 09:57:27 AM 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.8p12 +ntp-wait - Wait for ntpd to stabilize the system clock - Ver. 4.2.8p13 USAGE: ntp-wait [ -<flag> [<val>] | --<name>[{=| }<val>] ]... -n, --tries=num Number of times to check ntpd diff --git a/contrib/ntp/scripts/ntp-wait/ntp-wait.1ntp-waitman b/contrib/ntp/scripts/ntp-wait/ntp-wait.1ntp-waitman index d73885ad545b..90cc4da295a7 100644 --- a/contrib/ntp/scripts/ntp-wait/ntp-wait.1ntp-waitman +++ b/contrib/ntp/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 "14 Aug 2018" "ntp (4.2.8p12)" "User Commands" +.TH ntp-wait 1ntp-waitman "20 Feb 2019" "ntp (4.2.8p13)" "User Commands" .\" -.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-GBaimc/ag-SBaqlc) +.\" EDIT THIS FILE WITH CAUTION (in-mem file) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:04 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 09:57:30 AM by AutoGen 5.18.5 .\" From the definitions ntp-wait-opts.def .\" and the template file agman-cmd.tpl .SH NAME diff --git a/contrib/ntp/scripts/ntp-wait/ntp-wait.1ntp-waitmdoc b/contrib/ntp/scripts/ntp-wait/ntp-wait.1ntp-waitmdoc index 44ffe648c40b..368b273db5bd 100644 --- a/contrib/ntp/scripts/ntp-wait/ntp-wait.1ntp-waitmdoc +++ b/contrib/ntp/scripts/ntp-wait/ntp-wait.1ntp-waitmdoc @@ -1,9 +1,9 @@ -.Dd August 14 2018 +.Dd February 20 2019 .Dt NTP_WAIT 1ntp-waitmdoc User Commands .Os .\" EDIT THIS FILE WITH CAUTION (ntp-wait-opts.mdoc) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:10 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 09:57:27 AM by AutoGen 5.18.5 .\" From the definitions ntp-wait-opts.def .\" and the template file agmdoc-cmd.tpl .Sh NAME diff --git a/contrib/ntp/scripts/ntp-wait/ntp-wait.html b/contrib/ntp/scripts/ntp-wait/ntp-wait.html index 3679e8ba6c49..3b33e6de76d7 100644 --- a/contrib/ntp/scripts/ntp-wait/ntp-wait.html +++ b/contrib/ntp/scripts/ntp-wait/ntp-wait.html @@ -1,68 +1,105 @@ -<html lang="en"> +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ --> <head> -<title>Ntp-wait User's Manual</title> -<meta http-equiv="Content-Type" content="text/html"> -<meta name="description" content="Ntp-wait User's Manual"> -<meta name="generator" content="makeinfo 4.7"> -<link title="Top" rel="top" href="#Top"> -<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> -<meta http-equiv="Content-Style-Type" content="text/css"> -<style type="text/css"><!-- - pre.display { font-family:inherit } - pre.format { font-family:inherit } - pre.smalldisplay { font-family:inherit; font-size:smaller } - pre.smallformat { font-family:inherit; font-size:smaller } - pre.smallexample { font-size:smaller } - pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } ---></style> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>Ntp-wait User’s Manual</title> + +<meta name="description" content="Ntp-wait User’s Manual"> +<meta name="keywords" content="Ntp-wait User’s Manual"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<link href="#Top" rel="start" title="Top"> +<link href="dir.html#Top" rel="up" title="(dir)"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +blockquote.smallindentedblock {margin-right: 0em; font-size: smaller} +blockquote.smallquotation {font-size: smaller} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +div.smalldisplay {margin-left: 3.2em} +div.smallexample {margin-left: 3.2em} +div.smalllisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +pre.smalldisplay {font-family: inherit; font-size: smaller} +pre.smallexample {font-size: smaller} +pre.smallformat {font-family: inherit; font-size: smaller} +pre.smalllisp {font-size: smaller} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + + </head> -<body> -<h1 class="settitle">Ntp-wait User's Manual</h1> -<div class="node"> -<p><hr> -<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-Description">ntp-wait Description</a>, -Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>, -Up: <a rel="up" accesskey="u" href="#dir">(dir)</a> -<br> -</div> - <p>This document describes the use of the NTP Project's <code>ntp-wait</code> program. +<body lang="en"> +<h1 class="settitle" align="center">Ntp-wait User’s Manual</h1> + + + + - <p>If there are time-sensitive applications, +<a name="Top"></a> +<div class="header"> +<p> +Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> </p> +</div> +<h1 class="node-heading">Top</h1> + +<p>This document describes the use of the NTP Project’s <code>ntp-wait</code> program. +</p> +<p>If there are time-sensitive applications, the proper sequence of events is to run <code>ntpd -g</code> as early as possible, then invoke all of the non-time-sensitive process, run <code>ntp-wait</code> to block -until the system's time has stabilized and synchronized, +until the system’s time has stabilized and synchronized, and only then start any applicaitons (like database servers) that require accurate and stable time. - - <p>This document applies to version 4.2.8p12 of <code>ntp-wait</code>. +</p> +<p>This document applies to version 4.2.8p13 of <code>ntp-wait</code>. +</p> +<a name="SEC_Overview"></a> +<h2 class="shortcontents-heading">Short Table of Contents</h2> <div class="shortcontents"> -<h2>Short Contents</h2> -<ul> -</ul> +<li><a name="stoc-Invoking-ntp_002dwait" href="#toc-Invoking-ntp_002dwait">1 Invoking ntp-wait</a></li> + </div> -<ul class="menu"> -<li><a accesskey="1" href="#ntp_002dwait-Description">ntp-wait Description</a>: Description -<li><a accesskey="2" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a>: Invoking ntp-wait -</ul> -<div class="node"> -<p><hr> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• ntp-wait Description:</td><td> </td><td align="left" valign="top">Description +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntp_002dwait-Invocation" accesskey="2">ntp-wait Invocation</a>:</td><td> </td><td align="left" valign="top">Invoking ntp-wait +</td></tr> +</table> + +<hr> <a name="ntp_002dwait-Invocation"></a> -<br> +<div class="header"> +<p> +Up: <a href="#Top" accesskey="u" rel="up">Top</a> </p> </div> +<a name="Invoking-ntp_002dwait"></a> +<h3 class="section">1 Invoking ntp-wait</h3> +<a name="index-ntp_002dwait"></a> +<a name="index-Wait-for-ntpd-to-stabilize-the-system-clock"></a> -<h3 class="section">0.1 Invoking ntp-wait</h3> -<p><a name="index-ntp_002dwait-1"></a><a name="index-Wait-for-ntpd-to-stabilize-the-system-clock-2"></a> - <p><code>ntp-wait</code> +<p><code>ntp-wait</code> will send at most <kbd>num-tries</kbd> queries to @@ -72,50 +109,58 @@ sleeping for after each status return that says <code>ntpd(8)</code> has not yet produced a synchronized and stable system clock. - - <p><code>ntp-wait</code> +</p> +<p><code>ntp-wait</code> will do this quietly, unless the <code>-v</code> -flag is provided. +flag is provided. This can be useful at boot time, to delay the boot sequence until after <kbd>ntpd</kbd> <kbd>-g</kbd> has set the time. - - <p>This section was generated by <strong>AutoGen</strong>, +</p> +<p>This section was generated by <strong>AutoGen</strong>, using the <code>agtexi-cmd</code> template and the option descriptions for the <code>ntp-wait</code> program. - -<ul class="menu"> -<li><a accesskey="1" href="#ntp_002dwait-usage">ntp-wait usage</a>: ntp-wait help/usage (<span class="option">--help</span>) -<li><a accesskey="2" href="#ntp_002dwait-tries">ntp-wait tries</a>: tries option (-n) -<li><a accesskey="3" href="#ntp_002dwait-sleep">ntp-wait sleep</a>: sleep option (-s) -<li><a accesskey="4" href="#ntp_002dwait-verbose">ntp-wait verbose</a>: verbose option (-v) -<li><a accesskey="5" href="#ntp_002dwait-exit-status">ntp-wait exit status</a>: exit status -<li><a accesskey="6" href="#ntp_002dwait-Authors">ntp-wait Authors</a>: Authors -<li><a accesskey="7" href="#ntp_002dwait-Notes">ntp-wait Notes</a>: Notes -</ul> - -<div class="node"> -<p><hr> -<a name="ntp_002dwait-usage"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-tries">ntp-wait tries</a>, -Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a> -<br> +</p> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#ntp_002dwait-usage" accesskey="1">ntp-wait usage</a>:</td><td> </td><td align="left" valign="top">ntp-wait help/usage (<samp>--help</samp>) +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntp_002dwait-tries" accesskey="2">ntp-wait tries</a>:</td><td> </td><td align="left" valign="top">tries option (-n) +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntp_002dwait-sleep" accesskey="3">ntp-wait sleep</a>:</td><td> </td><td align="left" valign="top">sleep option (-s) +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntp_002dwait-verbose" accesskey="4">ntp-wait verbose</a>:</td><td> </td><td align="left" valign="top">verbose option (-v) +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntp_002dwait-exit-status" accesskey="5">ntp-wait exit status</a>:</td><td> </td><td align="left" valign="top">exit status +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntp_002dwait-Authors" accesskey="6">ntp-wait Authors</a>:</td><td> </td><td align="left" valign="top">Authors +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntp_002dwait-Notes" accesskey="7">ntp-wait Notes</a>:</td><td> </td><td align="left" valign="top">Notes +</td></tr> +</table> + +<hr> +<a name="ntp_002dwait-usage"></a> +<div class="header"> +<p> +Next: <a href="#ntp_002dwait-tries" accesskey="n" rel="next">ntp-wait tries</a>, Up: <a href="#ntp_002dwait-Invocation" accesskey="u" rel="up">ntp-wait Invocation</a> </p> </div> - -<h4 class="subsection">0.1.1 ntp-wait help/usage (<span class="option">--help</span>)</h4> - -<p><a name="index-ntp_002dwait-help-3"></a> -This is the automatically generated usage text for ntp-wait. - - <p>The text printed is the same whether selected with the <code>help</code> option -(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print -the usage text by passing it through a pager program. +<a name="ntp_002dwait-help_002fusage-_0028_002d_002dhelp_0029"></a> +<h4 class="subsection">1.1 ntp-wait help/usage (<samp>--help</samp>)</h4> +<a name="index-ntp_002dwait-help"></a> + +<p>This is the automatically generated usage text for ntp-wait. +</p> +<p>The text printed is the same whether selected with the <code>help</code> option +(<samp>--help</samp>) or the <code>more-help</code> option (<samp>--more-help</samp>). <code>more-help</code> will print +the usage text by passing it through a pager program. <code>more-help</code> is disabled on platforms without a working <code>fork(2)</code> function. The <code>PAGER</code> environment variable is -used to select the program, defaulting to <span class="file">more</span>. Both will exit +used to select the program, defaulting to <samp>more</samp>. Both will exit with a status code of 0. - -<pre class="example">ntp-wait - Wait for ntpd to stabilize the system clock - Ver. 4.2.8p12 -USAGE: ntp-wait [ -<flag> [<val>] | --<name>[{=| }<val>] ]... +</p> +<div class="example"> +<pre class="example">ntp-wait - Wait for ntpd to stabilize the system clock - Ver. 4.2.8p13 +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 @@ -125,84 +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. -</pre> - <div class="node"> -<p><hr> -<a name="ntp_002dwait-tries"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-sleep">ntp-wait sleep</a>, -Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait-usage">ntp-wait usage</a>, -Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a> -<br> -</div> +</pre></div> -<h4 class="subsection">0.1.2 tries option (-n)</h4> +<hr> +<a name="ntp_002dwait-tries"></a> +<div class="header"> +<p> +Next: <a href="#ntp_002dwait-sleep" accesskey="n" rel="next">ntp-wait sleep</a>, Previous: <a href="#ntp_002dwait-usage" accesskey="p" rel="prev">ntp-wait usage</a>, Up: <a href="#ntp_002dwait-Invocation" accesskey="u" rel="up">ntp-wait Invocation</a> </p> +</div> +<a name="tries-option-_0028_002dn_0029"></a> +<h4 class="subsection">1.2 tries option (-n)</h4> +<a name="index-ntp_002dwait_002dtries"></a> -<p><a name="index-ntp_002dwait_002dtries-4"></a> -This is the “number of times to check ntpd” option. -This option takes a number argument. +<p>This is the “number of times to check ntpd” option. +This option takes a number argument. The maximum number of times we will check <code>ntpd</code> to see if - it has been able to synchronize and stabilize the system clock. -<div class="node"> -<p><hr> -<a name="ntp_002dwait-sleep"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-verbose">ntp-wait verbose</a>, -Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait-tries">ntp-wait tries</a>, -Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a> -<br> + it has been able to synchronize and stabilize the system clock. +</p><hr> +<a name="ntp_002dwait-sleep"></a> +<div class="header"> +<p> +Next: <a href="#ntp_002dwait-verbose" accesskey="n" rel="next">ntp-wait verbose</a>, Previous: <a href="#ntp_002dwait-tries" accesskey="p" rel="prev">ntp-wait tries</a>, Up: <a href="#ntp_002dwait-Invocation" accesskey="u" rel="up">ntp-wait Invocation</a> </p> </div> - -<h4 class="subsection">0.1.3 sleep option (-s)</h4> - -<p><a name="index-ntp_002dwait_002dsleep-5"></a> -This is the “how long to sleep between tries” option. -This option takes a number argument <span class="file">secs-between-tries</span>. - We will sleep for <span class="file">secs-between-tries</span> after each query - of <code>ntpd</code> that returns "the time is not yet stable". -<div class="node"> -<p><hr> -<a name="ntp_002dwait-verbose"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-exit-status">ntp-wait exit status</a>, -Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait-sleep">ntp-wait sleep</a>, -Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a> -<br> +<a name="sleep-option-_0028_002ds_0029"></a> +<h4 class="subsection">1.3 sleep option (-s)</h4> +<a name="index-ntp_002dwait_002dsleep"></a> + +<p>This is the “how long to sleep between tries” option. +This option takes a number argument <samp>secs-between-tries</samp>. + We will sleep for <samp>secs-between-tries</samp> after each query + of <code>ntpd</code> that returns "the time is not yet stable". +</p><hr> +<a name="ntp_002dwait-verbose"></a> +<div class="header"> +<p> +Next: <a href="#ntp_002dwait-exit-status" accesskey="n" rel="next">ntp-wait exit status</a>, Previous: <a href="#ntp_002dwait-sleep" accesskey="p" rel="prev">ntp-wait sleep</a>, Up: <a href="#ntp_002dwait-Invocation" accesskey="u" rel="up">ntp-wait Invocation</a> </p> </div> - -<h4 class="subsection">0.1.4 verbose option (-v)</h4> - -<p><a name="index-ntp_002dwait_002dverbose-6"></a> -This is the “be verbose” option. - By default, <code>ntp-wait</code> is silent. - With this option, <code>ntp-wait</code> will provide status information. -<div class="node"> -<p><hr> -<a name="ntp_002dwait-exit-status"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-Authors">ntp-wait Authors</a>, -Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait-verbose">ntp-wait verbose</a>, -Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a> -<br> +<a name="verbose-option-_0028_002dv_0029"></a> +<h4 class="subsection">1.4 verbose option (-v)</h4> +<a name="index-ntp_002dwait_002dverbose"></a> + +<p>This is the “be verbose” option. + By default, <code>ntp-wait</code> is silent. + With this option, <code>ntp-wait</code> will provide status information. +</p><hr> +<a name="ntp_002dwait-exit-status"></a> +<div class="header"> +<p> +Next: <a href="#ntp_002dwait-Authors" accesskey="n" rel="next">ntp-wait Authors</a>, Previous: <a href="#ntp_002dwait-verbose" accesskey="p" rel="prev">ntp-wait verbose</a>, Up: <a href="#ntp_002dwait-Invocation" accesskey="u" rel="up">ntp-wait Invocation</a> </p> </div> - -<h4 class="subsection">0.1.5 ntp-wait exit status</h4> +<a name="ntp_002dwait-exit-status-1"></a> +<h4 class="subsection">1.5 ntp-wait exit status</h4> <p>One of the following exit values will be returned: - <dl> -<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution. -<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid. +</p><dl compact="compact"> +<dt>‘<samp>0 (EXIT_SUCCESS)</samp>’</dt> +<dd><p>Successful program execution. +</p></dd> +<dt>‘<samp>1 (EXIT_FAILURE)</samp>’</dt> +<dd><p>The operation failed or the command syntax was not valid. +</p></dd> </dl> - <div class="node"> -<p><hr> -<a name="ntp_002dwait-Authors"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-Notes">ntp-wait Notes</a>, -Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait-exit-status">ntp-wait exit status</a>, -Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a> -<br> +<hr> +<a name="ntp_002dwait-Authors"></a> +<div class="header"> +<p> +Next: <a href="#ntp_002dwait-Notes" accesskey="n" rel="next">ntp-wait Notes</a>, Previous: <a href="#ntp_002dwait-exit-status" accesskey="p" rel="prev">ntp-wait exit status</a>, Up: <a href="#ntp_002dwait-Invocation" accesskey="u" rel="up">ntp-wait Invocation</a> </p> </div> - -<h4 class="subsection">0.1.6 ntp-wait Authors</h4> - -<div class="node"> -<p><hr> -<a name="ntp_002dwait-Notes"></a>Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait-Authors">ntp-wait Authors</a>, -Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a> -<br> +<a name="ntp_002dwait-Authors-1"></a> +<h4 class="subsection">1.6 ntp-wait Authors</h4> +<hr> +<a name="ntp_002dwait-Notes"></a> +<div class="header"> +<p> +Previous: <a href="#ntp_002dwait-Authors" accesskey="p" rel="prev">ntp-wait Authors</a>, Up: <a href="#ntp_002dwait-Invocation" accesskey="u" rel="up">ntp-wait Invocation</a> </p> </div> +<a name="ntp_002dwait-Notes-1"></a> +<h4 class="subsection">1.7 ntp-wait Notes</h4> +<hr> -<h4 class="subsection">0.1.7 ntp-wait Notes</h4> -</body></html> +</body> +</html> diff --git a/contrib/ntp/scripts/ntp-wait/ntp-wait.man.in b/contrib/ntp/scripts/ntp-wait/ntp-wait.man.in index 1b41badc0a82..62a4124aa839 100644 --- a/contrib/ntp/scripts/ntp-wait/ntp-wait.man.in +++ b/contrib/ntp/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@ "14 Aug 2018" "ntp (4.2.8p12)" "User Commands" +.TH ntp-wait @NTP_WAIT_MS@ "20 Feb 2019" "ntp (4.2.8p13)" "User Commands" .\" -.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-GBaimc/ag-SBaqlc) +.\" EDIT THIS FILE WITH CAUTION (in-mem file) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:04 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 09:57:30 AM by AutoGen 5.18.5 .\" From the definitions ntp-wait-opts.def .\" and the template file agman-cmd.tpl .SH NAME diff --git a/contrib/ntp/scripts/ntp-wait/ntp-wait.mdoc.in b/contrib/ntp/scripts/ntp-wait/ntp-wait.mdoc.in index 127f14f5caba..ae0195bf2a33 100644 --- a/contrib/ntp/scripts/ntp-wait/ntp-wait.mdoc.in +++ b/contrib/ntp/scripts/ntp-wait/ntp-wait.mdoc.in @@ -1,9 +1,9 @@ -.Dd August 14 2018 +.Dd February 20 2019 .Dt NTP_WAIT @NTP_WAIT_MS@ User Commands .Os .\" EDIT THIS FILE WITH CAUTION (ntp-wait-opts.mdoc) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:10 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 09:57:27 AM by AutoGen 5.18.5 .\" From the definitions ntp-wait-opts.def .\" and the template file agmdoc-cmd.tpl .Sh NAME diff --git a/contrib/ntp/scripts/ntpsweep/Makefile.in b/contrib/ntp/scripts/ntpsweep/Makefile.in index 45c56c098ec6..6db2194d98bb 100644 --- a/contrib/ntp/scripts/ntpsweep/Makefile.in +++ b/contrib/ntp/scripts/ntpsweep/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.15 from Makefile.am. +# Makefile.in generated by automake 1.15.1 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2014 Free Software Foundation, Inc. +# Copyright (C) 1994-2017 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, diff --git a/contrib/ntp/scripts/ntpsweep/invoke-ntpsweep.texi b/contrib/ntp/scripts/ntpsweep/invoke-ntpsweep.texi index 60c1f7bff162..5375dc10ef27 100644 --- a/contrib/ntp/scripts/ntpsweep/invoke-ntpsweep.texi +++ b/contrib/ntp/scripts/ntpsweep/invoke-ntpsweep.texi @@ -6,7 +6,7 @@ # # EDIT THIS FILE WITH CAUTION (invoke-ntpsweep.texi) # -# It has been AutoGen-ed August 14, 2018 at 08:09:13 AM by AutoGen 5.18.5 +# It has been AutoGen-ed February 20, 2019 at 09:57:31 AM 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.8p12 +ntpsweep - Print various informations about given ntp servers - Ver. 4.2.8p13 USAGE: ntpsweep [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... [hostfile] -l, --host-list=str Host to execute actions on diff --git a/contrib/ntp/scripts/ntpsweep/ntpsweep-opts b/contrib/ntp/scripts/ntpsweep/ntpsweep-opts index c754a3f45576..5bd7126f5d66 100644 --- a/contrib/ntp/scripts/ntpsweep/ntpsweep-opts +++ b/contrib/ntp/scripts/ntpsweep/ntpsweep-opts @@ -1,6 +1,6 @@ # EDIT THIS FILE WITH CAUTION (ntpsweep-opts) # -# It has been AutoGen-ed August 14, 2018 at 08:09:11 AM by AutoGen 5.18.5 +# It has been AutoGen-ed February 20, 2019 at 09:57:31 AM 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.8p12 +ntpsweep - Print various informations about given ntp servers - Ver. 4.2.8p13 USAGE: ntpsweep [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [hostfile] -l, --host-list=str Host to execute actions on diff --git a/contrib/ntp/scripts/ntpsweep/ntpsweep.1ntpsweepman b/contrib/ntp/scripts/ntpsweep/ntpsweep.1ntpsweepman index fa4ab4bd0b22..5d2edeeb276d 100644 --- a/contrib/ntp/scripts/ntpsweep/ntpsweep.1ntpsweepman +++ b/contrib/ntp/scripts/ntpsweep/ntpsweep.1ntpsweepman @@ -10,11 +10,11 @@ .ds B-Font B .ds I-Font I .ds R-Font R -.TH ntpsweep 1ntpsweepman "14 Aug 2018" "ntp (4.2.8p12)" "User Commands" +.TH ntpsweep 1ntpsweepman "20 Feb 2019" "ntp (4.2.8p13)" "User Commands" .\" -.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-csaqyd/ag-psayxd) +.\" EDIT THIS FILE WITH CAUTION (in-mem file) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:15 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 09:57:33 AM by AutoGen 5.18.5 .\" From the definitions ntpsweep-opts.def .\" and the template file agman-cmd.tpl .SH NAME diff --git a/contrib/ntp/scripts/ntpsweep/ntpsweep.1ntpsweepmdoc b/contrib/ntp/scripts/ntpsweep/ntpsweep.1ntpsweepmdoc index 43c44a2b52d2..d958cde67aa1 100644 --- a/contrib/ntp/scripts/ntpsweep/ntpsweep.1ntpsweepmdoc +++ b/contrib/ntp/scripts/ntpsweep/ntpsweep.1ntpsweepmdoc @@ -1,9 +1,9 @@ -.Dd August 14 2018 +.Dd February 20 2019 .Dt NTPSWEEP 1ntpsweepmdoc User Commands .Os .\" EDIT THIS FILE WITH CAUTION (ntpsweep-opts.mdoc) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:18 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 09:57:32 AM by AutoGen 5.18.5 .\" From the definitions ntpsweep-opts.def .\" and the template file agmdoc-cmd.tpl .Sh NAME diff --git a/contrib/ntp/scripts/ntpsweep/ntpsweep.html b/contrib/ntp/scripts/ntpsweep/ntpsweep.html index 8c9737e95f81..61095d421ed1 100644 --- a/contrib/ntp/scripts/ntpsweep/ntpsweep.html +++ b/contrib/ntp/scripts/ntpsweep/ntpsweep.html @@ -1,96 +1,140 @@ -<html lang="en"> +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ --> <head> -<title>ntpsweep User's Manual</title> -<meta http-equiv="Content-Type" content="text/html"> -<meta name="description" content="ntpsweep User's Manual"> -<meta name="generator" content="makeinfo 4.7"> -<link title="Top" rel="top" href="#Top"> -<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> -<meta http-equiv="Content-Style-Type" content="text/css"> -<style type="text/css"><!-- - pre.display { font-family:inherit } - pre.format { font-family:inherit } - pre.smalldisplay { font-family:inherit; font-size:smaller } - pre.smallformat { font-family:inherit; font-size:smaller } - pre.smallexample { font-size:smaller } - pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } ---></style> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>ntpsweep User’s Manual</title> + +<meta name="description" content="ntpsweep User’s Manual"> +<meta name="keywords" content="ntpsweep User’s Manual"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<link href="#Top" rel="start" title="Top"> +<link href="dir.html#Top" rel="up" title="(dir)"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +blockquote.smallindentedblock {margin-right: 0em; font-size: smaller} +blockquote.smallquotation {font-size: smaller} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +div.smalldisplay {margin-left: 3.2em} +div.smallexample {margin-left: 3.2em} +div.smalllisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +pre.smalldisplay {font-family: inherit; font-size: smaller} +pre.smallexample {font-size: smaller} +pre.smallformat {font-family: inherit; font-size: smaller} +pre.smalllisp {font-size: smaller} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + + </head> -<body> -<h1 class="settitle">ntpsweep User's Manual</h1> -<div class="node"> -<p><hr> -<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntpsweep-Description">ntpsweep Description</a>, -Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>, -Up: <a rel="up" accesskey="u" href="#dir">(dir)</a> -<br> + +<body lang="en"> +<h1 class="settitle" align="center">ntpsweep User’s Manual</h1> + + + + + +<a name="Top"></a> +<div class="header"> +<p> +Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> </p> </div> +<h1 class="node-heading">Top</h1> - <p>This document describes the use of the NTP Project's <code>ntpsweep</code> program. +<p>This document describes the use of the NTP Project’s <code>ntpsweep</code> program. +</p> +<p>This document applies to version 4.2.8p13 of <code>ntpsweep</code>. +</p> +<a name="SEC_Overview"></a> +<h2 class="shortcontents-heading">Short Table of Contents</h2> - <p>This document applies to version 4.2.8p12 of <code>ntpsweep</code>. +<div class="shortcontents"> +<li><a name="stoc-Invoking-ntpsweep" href="#toc-Invoking-ntpsweep">1 Invoking ntpsweep</a></li> - <div class="shortcontents"> -<h2>Short Contents</h2> -<ul> -</ul> </div> -<ul class="menu"> -<li><a accesskey="1" href="#ntpsweep-Description">ntpsweep Description</a>: Description -<li><a accesskey="2" href="#ntpsweep-Invocation">ntpsweep Invocation</a>: Invoking ntpsweep -</ul> -<div class="node"> -<p><hr> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• ntpsweep Description:</td><td> </td><td align="left" valign="top">Description +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntpsweep-Invocation" accesskey="2">ntpsweep Invocation</a>:</td><td> </td><td align="left" valign="top">Invoking ntpsweep +</td></tr> +</table> + +<hr> <a name="ntpsweep-Invocation"></a> -<br> +<div class="header"> +<p> +Up: <a href="#Top" accesskey="u" rel="up">Top</a> </p> </div> +<a name="Invoking-ntpsweep"></a> +<h3 class="section">1 Invoking ntpsweep</h3> +<a name="index-ntpsweep"></a> +<a name="index-Print-various-informations-about-given-ntp-servers"></a> -<h3 class="section">0.1 Invoking ntpsweep</h3> - -<p><a name="index-ntpsweep-1"></a><a name="index-Print-various-informations-about-given-ntp-servers-2"></a> -<code>ntpsweep</code> +<p><code>ntpsweep</code> prints per host the NTP stratum level, the clock offset in seconds, the daemon version, the operating system and the processor. Optionally recursing through all peers. - - <p>This section was generated by <strong>AutoGen</strong>, +</p> +<p>This section was generated by <strong>AutoGen</strong>, using the <code>agtexi-cmd</code> template and the option descriptions for the <code>ntpsweep</code> program. - -<ul class="menu"> -<li><a accesskey="1" href="#ntpsweep-usage">ntpsweep usage</a>: ntpsweep help/usage (<span class="option">--help</span>) -<li><a accesskey="2" href="#ntpsweep-host_002dlist">ntpsweep host-list</a>: host-list option (-l) -<li><a accesskey="3" href="#ntpsweep-peers">ntpsweep peers</a>: peers option (-p) -<li><a accesskey="4" href="#ntpsweep-maxlevel">ntpsweep maxlevel</a>: maxlevel option (-m) -<li><a accesskey="5" href="#ntpsweep-strip">ntpsweep strip</a>: strip option (-s) -<li><a accesskey="6" href="#ntpsweep-host">ntpsweep host</a>: host option (-h) -<li><a accesskey="7" href="#ntpsweep-exit-status">ntpsweep exit status</a>: exit status -</ul> - -<div class="node"> -<p><hr> -<a name="ntpsweep-usage"></a>Next: <a rel="next" accesskey="n" href="#ntpsweep-host_002dlist">ntpsweep host-list</a>, -Up: <a rel="up" accesskey="u" href="#ntpsweep-Invocation">ntpsweep Invocation</a> -<br> +</p> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#ntpsweep-usage" accesskey="1">ntpsweep usage</a>:</td><td> </td><td align="left" valign="top">ntpsweep help/usage (<samp>--help</samp>) +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntpsweep-host_002dlist" accesskey="2">ntpsweep host-list</a>:</td><td> </td><td align="left" valign="top">host-list option (-l) +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntpsweep-peers" accesskey="3">ntpsweep peers</a>:</td><td> </td><td align="left" valign="top">peers option (-p) +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntpsweep-maxlevel" accesskey="4">ntpsweep maxlevel</a>:</td><td> </td><td align="left" valign="top">maxlevel option (-m) +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntpsweep-strip" accesskey="5">ntpsweep strip</a>:</td><td> </td><td align="left" valign="top">strip option (-s) +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntpsweep-host" accesskey="6">ntpsweep host</a>:</td><td> </td><td align="left" valign="top">host option (-h) +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntpsweep-exit-status" accesskey="7">ntpsweep exit status</a>:</td><td> </td><td align="left" valign="top">exit status +</td></tr> +</table> + +<hr> +<a name="ntpsweep-usage"></a> +<div class="header"> +<p> +Next: <a href="#ntpsweep-host_002dlist" accesskey="n" rel="next">ntpsweep host-list</a>, Up: <a href="#ntpsweep-Invocation" accesskey="u" rel="up">ntpsweep Invocation</a> </p> </div> - -<h4 class="subsection">0.1.1 ntpsweep help/usage (<span class="option">--help</span>)</h4> - -<p><a name="index-ntpsweep-help-3"></a> -This is the automatically generated usage text for ntpsweep. - - <p>The text printed is the same whether selected with the <code>help</code> option -(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print -the usage text by passing it through a pager program. +<a name="ntpsweep-help_002fusage-_0028_002d_002dhelp_0029"></a> +<h4 class="subsection">1.1 ntpsweep help/usage (<samp>--help</samp>)</h4> +<a name="index-ntpsweep-help"></a> + +<p>This is the automatically generated usage text for ntpsweep. +</p> +<p>The text printed is the same whether selected with the <code>help</code> option +(<samp>--help</samp>) or the <code>more-help</code> option (<samp>--more-help</samp>). <code>more-help</code> will print +the usage text by passing it through a pager program. <code>more-help</code> is disabled on platforms without a working <code>fork(2)</code> function. The <code>PAGER</code> environment variable is -used to select the program, defaulting to <span class="file">more</span>. Both will exit +used to select the program, defaulting to <samp>more</samp>. Both will exit with a status code of 0. - -<pre class="example">ntpsweep - Print various informations about given ntp servers - Ver. 4.2.8p12 +</p> +<div class="example"> +<pre class="example">ntpsweep - Print various informations about given ntp servers - Ver. 4.2.8p13 USAGE: ntpsweep [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [hostfile] -l, --host-list=str Host to execute actions on @@ -103,99 +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. -</pre> - <div class="node"> -<p><hr> -<a name="ntpsweep-host_002dlist"></a>Next: <a rel="next" accesskey="n" href="#ntpsweep-peers">ntpsweep peers</a>, -Previous: <a rel="previous" accesskey="p" href="#ntpsweep-usage">ntpsweep usage</a>, -Up: <a rel="up" accesskey="u" href="#ntpsweep-Invocation">ntpsweep Invocation</a> -<br> -</div> +</pre></div> -<h4 class="subsection">0.1.2 host-list option (-l)</h4> +<hr> +<a name="ntpsweep-host_002dlist"></a> +<div class="header"> +<p> +Next: <a href="#ntpsweep-peers" accesskey="n" rel="next">ntpsweep peers</a>, Previous: <a href="#ntpsweep-usage" accesskey="p" rel="prev">ntpsweep usage</a>, Up: <a href="#ntpsweep-Invocation" accesskey="u" rel="up">ntpsweep Invocation</a> </p> +</div> +<a name="host_002dlist-option-_0028_002dl_0029"></a> +<h4 class="subsection">1.2 host-list option (-l)</h4> +<a name="index-ntpsweep_002dhost_002dlist"></a> -<p><a name="index-ntpsweep_002dhost_002dlist-4"></a> -This is the “host to execute actions on” option. +<p>This is the “host to execute actions on” option. This option takes a string argument. - -<p class="noindent">This option has some usage constraints. It: - <ul> -<li>may appear an unlimited number of times. -</ul> - - <p>Use this option to specify the host on which this script operates. - May appear multiple times. -<div class="node"> -<p><hr> -<a name="ntpsweep-peers"></a>Next: <a rel="next" accesskey="n" href="#ntpsweep-maxlevel">ntpsweep maxlevel</a>, -Previous: <a rel="previous" accesskey="p" href="#ntpsweep-host_002dlist">ntpsweep host-list</a>, -Up: <a rel="up" accesskey="u" href="#ntpsweep-Invocation">ntpsweep Invocation</a> -<br> +</p> +<p>This option has some usage constraints. It: +</p><ul> +<li> may appear an unlimited number of times. +</li></ul> + +<p>Use this option to specify the host on which this script operates. + May appear multiple times. +</p><hr> +<a name="ntpsweep-peers"></a> +<div class="header"> +<p> +Next: <a href="#ntpsweep-maxlevel" accesskey="n" rel="next">ntpsweep maxlevel</a>, Previous: <a href="#ntpsweep-host_002dlist" accesskey="p" rel="prev">ntpsweep host-list</a>, Up: <a href="#ntpsweep-Invocation" accesskey="u" rel="up">ntpsweep Invocation</a> </p> </div> - -<h4 class="subsection">0.1.3 peers option (-p)</h4> - -<p><a name="index-ntpsweep_002dpeers-5"></a> -This is the “recursively list all peers a host synchronizes to” option. -This option has no <span class="samp">doc</span> documentation. -<div class="node"> -<p><hr> -<a name="ntpsweep-maxlevel"></a>Next: <a rel="next" accesskey="n" href="#ntpsweep-strip">ntpsweep strip</a>, -Previous: <a rel="previous" accesskey="p" href="#ntpsweep-peers">ntpsweep peers</a>, -Up: <a rel="up" accesskey="u" href="#ntpsweep-Invocation">ntpsweep Invocation</a> -<br> +<a name="peers-option-_0028_002dp_0029"></a> +<h4 class="subsection">1.3 peers option (-p)</h4> +<a name="index-ntpsweep_002dpeers"></a> + +<p>This is the “recursively list all peers a host synchronizes to” option. +This option has no ‘<samp>doc</samp>’ documentation. +</p><hr> +<a name="ntpsweep-maxlevel"></a> +<div class="header"> +<p> +Next: <a href="#ntpsweep-strip" accesskey="n" rel="next">ntpsweep strip</a>, Previous: <a href="#ntpsweep-peers" accesskey="p" rel="prev">ntpsweep peers</a>, Up: <a href="#ntpsweep-Invocation" accesskey="u" rel="up">ntpsweep Invocation</a> </p> </div> - -<h4 class="subsection">0.1.4 maxlevel option (-m)</h4> - -<p><a name="index-ntpsweep_002dmaxlevel-6"></a> -This is the “traverse peers up to this level (4 is a reasonable number)” option. -This option takes a number argument. -This option has no <span class="samp">doc</span> documentation. -<div class="node"> -<p><hr> -<a name="ntpsweep-strip"></a>Next: <a rel="next" accesskey="n" href="#ntpsweep-host">ntpsweep host</a>, -Previous: <a rel="previous" accesskey="p" href="#ntpsweep-maxlevel">ntpsweep maxlevel</a>, -Up: <a rel="up" accesskey="u" href="#ntpsweep-Invocation">ntpsweep Invocation</a> -<br> +<a name="maxlevel-option-_0028_002dm_0029"></a> +<h4 class="subsection">1.4 maxlevel option (-m)</h4> +<a name="index-ntpsweep_002dmaxlevel"></a> + +<p>This is the “traverse peers up to this level (4 is a reasonable number)” option. +This option takes a number argument. +This option has no ‘<samp>doc</samp>’ documentation. +</p><hr> +<a name="ntpsweep-strip"></a> +<div class="header"> +<p> +Next: <a href="#ntpsweep-host" accesskey="n" rel="next">ntpsweep host</a>, Previous: <a href="#ntpsweep-maxlevel" accesskey="p" rel="prev">ntpsweep maxlevel</a>, Up: <a href="#ntpsweep-Invocation" accesskey="u" rel="up">ntpsweep Invocation</a> </p> </div> +<a name="strip-option-_0028_002ds_0029"></a> +<h4 class="subsection">1.5 strip option (-s)</h4> +<a name="index-ntpsweep_002dstrip"></a> -<h4 class="subsection">0.1.5 strip option (-s)</h4> - -<p><a name="index-ntpsweep_002dstrip-7"></a> -This is the “strip this string from hostnames” option. -This option takes a string argument. -This option has no <span class="samp">doc</span> documentation. -<div class="node"> -<p><hr> -<a name="ntpsweep-host"></a>Next: <a rel="next" accesskey="n" href="#ntpsweep-exit-status">ntpsweep exit status</a>, -Previous: <a rel="previous" accesskey="p" href="#ntpsweep-strip">ntpsweep strip</a>, -Up: <a rel="up" accesskey="u" href="#ntpsweep-Invocation">ntpsweep Invocation</a> -<br> +<p>This is the “strip this string from hostnames” option. +This option takes a string argument. +This option has no ‘<samp>doc</samp>’ documentation. +</p><hr> +<a name="ntpsweep-host"></a> +<div class="header"> +<p> +Next: <a href="#ntpsweep-exit-status" accesskey="n" rel="next">ntpsweep exit status</a>, Previous: <a href="#ntpsweep-strip" accesskey="p" rel="prev">ntpsweep strip</a>, Up: <a href="#ntpsweep-Invocation" accesskey="u" rel="up">ntpsweep Invocation</a> </p> </div> +<a name="host-option-_0028_002dh_0029"></a> +<h4 class="subsection">1.6 host option (-h)</h4> +<a name="index-ntpsweep_002dhost"></a> -<h4 class="subsection">0.1.6 host option (-h)</h4> - -<p><a name="index-ntpsweep_002dhost-8"></a> -This is the “specify a single host” option. -This option takes a string argument. -This option has no <span class="samp">doc</span> documentation. - - <p><strong>NOTE</strong><strong>: THIS OPTION IS DEPRECATED</strong> -<div class="node"> -<p><hr> -<a name="ntpsweep-exit-status"></a>Previous: <a rel="previous" accesskey="p" href="#ntpsweep-host">ntpsweep host</a>, -Up: <a rel="up" accesskey="u" href="#ntpsweep-Invocation">ntpsweep Invocation</a> -<br> +<p>This is the “specify a single host” option. +This option takes a string argument. +This option has no ‘<samp>doc</samp>’ documentation. +</p> +<p><strong>NOTE</strong><strong>: THIS OPTION IS DEPRECATED</strong> +</p><hr> +<a name="ntpsweep-exit-status"></a> +<div class="header"> +<p> +Previous: <a href="#ntpsweep-host" accesskey="p" rel="prev">ntpsweep host</a>, Up: <a href="#ntpsweep-Invocation" accesskey="u" rel="up">ntpsweep Invocation</a> </p> </div> - -<h4 class="subsection">0.1.7 ntpsweep exit status</h4> +<a name="ntpsweep-exit-status-1"></a> +<h4 class="subsection">1.7 ntpsweep exit status</h4> <p>One of the following exit values will be returned: - <dl> -<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution. -<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid. +</p><dl compact="compact"> +<dt>‘<samp>0 (EXIT_SUCCESS)</samp>’</dt> +<dd><p>Successful program execution. +</p></dd> +<dt>‘<samp>1 (EXIT_FAILURE)</samp>’</dt> +<dd><p>The operation failed or the command syntax was not valid. +</p></dd> </dl> +<hr> + -</body></html> +</body> +</html> diff --git a/contrib/ntp/scripts/ntpsweep/ntpsweep.man.in b/contrib/ntp/scripts/ntpsweep/ntpsweep.man.in index fa4ab4bd0b22..5d2edeeb276d 100644 --- a/contrib/ntp/scripts/ntpsweep/ntpsweep.man.in +++ b/contrib/ntp/scripts/ntpsweep/ntpsweep.man.in @@ -10,11 +10,11 @@ .ds B-Font B .ds I-Font I .ds R-Font R -.TH ntpsweep 1ntpsweepman "14 Aug 2018" "ntp (4.2.8p12)" "User Commands" +.TH ntpsweep 1ntpsweepman "20 Feb 2019" "ntp (4.2.8p13)" "User Commands" .\" -.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-csaqyd/ag-psayxd) +.\" EDIT THIS FILE WITH CAUTION (in-mem file) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:15 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 09:57:33 AM by AutoGen 5.18.5 .\" From the definitions ntpsweep-opts.def .\" and the template file agman-cmd.tpl .SH NAME diff --git a/contrib/ntp/scripts/ntpsweep/ntpsweep.mdoc.in b/contrib/ntp/scripts/ntpsweep/ntpsweep.mdoc.in index 43c44a2b52d2..d958cde67aa1 100644 --- a/contrib/ntp/scripts/ntpsweep/ntpsweep.mdoc.in +++ b/contrib/ntp/scripts/ntpsweep/ntpsweep.mdoc.in @@ -1,9 +1,9 @@ -.Dd August 14 2018 +.Dd February 20 2019 .Dt NTPSWEEP 1ntpsweepmdoc User Commands .Os .\" EDIT THIS FILE WITH CAUTION (ntpsweep-opts.mdoc) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:18 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 09:57:32 AM by AutoGen 5.18.5 .\" From the definitions ntpsweep-opts.def .\" and the template file agmdoc-cmd.tpl .Sh NAME diff --git a/contrib/ntp/scripts/ntptrace/Makefile.in b/contrib/ntp/scripts/ntptrace/Makefile.in index 7ce26143cf70..9d87e0e8a103 100644 --- a/contrib/ntp/scripts/ntptrace/Makefile.in +++ b/contrib/ntp/scripts/ntptrace/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.15 from Makefile.am. +# Makefile.in generated by automake 1.15.1 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2014 Free Software Foundation, Inc. +# Copyright (C) 1994-2017 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, diff --git a/contrib/ntp/scripts/ntptrace/invoke-ntptrace.texi b/contrib/ntp/scripts/ntptrace/invoke-ntptrace.texi index 072434f22494..746689e438d1 100644 --- a/contrib/ntp/scripts/ntptrace/invoke-ntptrace.texi +++ b/contrib/ntp/scripts/ntptrace/invoke-ntptrace.texi @@ -6,7 +6,7 @@ # # EDIT THIS FILE WITH CAUTION (invoke-ntptrace.texi) # -# It has been AutoGen-ed August 14, 2018 at 08:09:25 AM by AutoGen 5.18.5 +# It has been AutoGen-ed February 20, 2019 at 09:57:36 AM 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.8p12 +ntptrace - Trace peers of an NTP server - Ver. 4.2.8p13 USAGE: ntptrace [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... [host] -n, --numeric Print IP addresses instead of hostnames diff --git a/contrib/ntp/scripts/ntptrace/ntptrace-opts b/contrib/ntp/scripts/ntptrace/ntptrace-opts index 5e15567def8a..6545bff7a723 100644 --- a/contrib/ntp/scripts/ntptrace/ntptrace-opts +++ b/contrib/ntp/scripts/ntptrace/ntptrace-opts @@ -1,6 +1,6 @@ # EDIT THIS FILE WITH CAUTION (ntptrace-opts) # -# It has been AutoGen-ed August 14, 2018 at 08:09:20 AM by AutoGen 5.18.5 +# It has been AutoGen-ed February 20, 2019 at 09:57:35 AM 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.8p12 +ntptrace - Trace peers of an NTP server - Ver. 4.2.8p13 USAGE: ntptrace [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [host] -n, --numeric Print IP addresses instead of hostnames diff --git a/contrib/ntp/scripts/ntptrace/ntptrace.1ntptraceman b/contrib/ntp/scripts/ntptrace/ntptrace.1ntptraceman index f9c3b53bc80e..79864da8e6db 100644 --- a/contrib/ntp/scripts/ntptrace/ntptrace.1ntptraceman +++ b/contrib/ntp/scripts/ntptrace/ntptrace.1ntptraceman @@ -10,11 +10,11 @@ .ds B-Font B .ds I-Font I .ds R-Font R -.TH ntptrace 1ntptraceman "14 Aug 2018" "ntp (4.2.8p12)" "User Commands" +.TH ntptrace 1ntptraceman "20 Feb 2019" "ntp (4.2.8p13)" "User Commands" .\" -.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-n1aOAe/ag-B1aWze) +.\" EDIT THIS FILE WITH CAUTION (in-mem file) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:22 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 09:57:37 AM by AutoGen 5.18.5 .\" From the definitions ntptrace-opts.def .\" and the template file agman-cmd.tpl .SH NAME diff --git a/contrib/ntp/scripts/ntptrace/ntptrace.1ntptracemdoc b/contrib/ntp/scripts/ntptrace/ntptrace.1ntptracemdoc index fc8301ba1417..7a535d0a53ce 100644 --- a/contrib/ntp/scripts/ntptrace/ntptrace.1ntptracemdoc +++ b/contrib/ntp/scripts/ntptrace/ntptrace.1ntptracemdoc @@ -1,9 +1,9 @@ -.Dd August 14 2018 +.Dd February 20 2019 .Dt NTPTRACE 1ntptracemdoc User Commands .Os .\" EDIT THIS FILE WITH CAUTION (ntptrace-opts.mdoc) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:27 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 09:57:35 AM by AutoGen 5.18.5 .\" From the definitions ntptrace-opts.def .\" and the template file agmdoc-cmd.tpl .Sh NAME diff --git a/contrib/ntp/scripts/ntptrace/ntptrace.html b/contrib/ntp/scripts/ntptrace/ntptrace.html index 3026102e667d..9160de2316dc 100644 --- a/contrib/ntp/scripts/ntptrace/ntptrace.html +++ b/contrib/ntp/scripts/ntptrace/ntptrace.html @@ -1,113 +1,156 @@ -<html lang="en"> +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ --> <head> -<title>Ntptrace User's Manual</title> -<meta http-equiv="Content-Type" content="text/html"> -<meta name="description" content="Ntptrace User's Manual"> -<meta name="generator" content="makeinfo 4.7"> -<link title="Top" rel="top" href="#Top"> -<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> -<meta http-equiv="Content-Style-Type" content="text/css"> -<style type="text/css"><!-- - pre.display { font-family:inherit } - pre.format { font-family:inherit } - pre.smalldisplay { font-family:inherit; font-size:smaller } - pre.smallformat { font-family:inherit; font-size:smaller } - pre.smallexample { font-size:smaller } - pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } ---></style> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>Ntptrace User’s Manual</title> + +<meta name="description" content="Ntptrace User’s Manual"> +<meta name="keywords" content="Ntptrace User’s Manual"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<link href="#Top" rel="start" title="Top"> +<link href="dir.html#Top" rel="up" title="(dir)"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +blockquote.smallindentedblock {margin-right: 0em; font-size: smaller} +blockquote.smallquotation {font-size: smaller} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +div.smalldisplay {margin-left: 3.2em} +div.smallexample {margin-left: 3.2em} +div.smalllisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +pre.smalldisplay {font-family: inherit; font-size: smaller} +pre.smallexample {font-size: smaller} +pre.smallformat {font-family: inherit; font-size: smaller} +pre.smalllisp {font-size: smaller} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + + </head> -<body> -<h1 class="settitle">Ntptrace User's Manual</h1> -<div class="node"> -<p><hr> -<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntptrace-Description">ntptrace Description</a>, -Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>, -Up: <a rel="up" accesskey="u" href="#dir">(dir)</a> -<br> -</div> -<h2 class="unnumbered">Simple Network Time Protocol User Manual</h2> +<body lang="en"> +<h1 class="settitle" align="center">Ntptrace User’s Manual</h1> + + + -<p>This document describes the use of the NTP Project's <code>ntptrace</code> program. -This document applies to version 4.2.8p12 of <code>ntptrace</code>. - <div class="shortcontents"> -<h2>Short Contents</h2> -<ul> -<a href="#Top">Simple Network Time Protocol User Manual</a> +<a name="Top"></a> +<div class="header"> +<p> +Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> </p> +</div> +<a name="Simple-Network-Time-Protocol-User-Manual"></a> +<h1 class="top">Simple Network Time Protocol User Manual</h1> + +<p>This document describes the use of the NTP Project’s <code>ntptrace</code> program. +This document applies to version 4.2.8p13 of <code>ntptrace</code>. +</p> +<a name="SEC_Overview"></a> +<h2 class="shortcontents-heading">Short Table of Contents</h2> + +<div class="shortcontents"> +<ul class="no-bullet"> +<li><a name="stoc-Invoking-ntptrace" href="#toc-Invoking-ntptrace">1 Invoking ntptrace</a></li> </ul> </div> -<ul class="menu"> -<li><a accesskey="1" href="#ntptrace-Description">ntptrace Description</a>: Description -<li><a accesskey="2" href="#ntptrace-Invocation">ntptrace Invocation</a>: Invoking ntptrace -</ul> -<div class="node"> -<p><hr> -<a name="ntptrace-Invocation"></a>Previous: <a rel="previous" accesskey="p" href="#ntptrace-Description">ntptrace Description</a>, -Up: <a rel="up" accesskey="u" href="#Top">Top</a> -<br> -</div> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• ntptrace Description:</td><td> </td><td align="left" valign="top">Description +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntptrace-Invocation" accesskey="2">ntptrace Invocation</a>:</td><td> </td><td align="left" valign="top">Invoking ntptrace +</td></tr> +</table> -<h3 class="section">Invoking ntptrace</h3> +<hr> +<a name="ntptrace-Invocation"></a> +<div class="header"> +<p> +Up: <a href="#Top" accesskey="u" rel="up">Top</a> </p> +</div> +<a name="Invoking-ntptrace"></a> +<h2 class="chapter">1 Invoking ntptrace</h2> +<a name="index-ntptrace"></a> +<a name="index-Trace-peers-of-an-NTP-server"></a> -<p><a name="index-ntptrace-1"></a><a name="index-Trace-peers-of-an-NTP-server-2"></a> -<code>ntptrace</code> is a perl script that uses the ntpq utility program to follow +<p><code>ntptrace</code> is a perl script that uses the ntpq utility program to follow the chain of NTP servers from a given host back to the primary time source. For ntptrace to work properly, each of these servers must implement the NTP Control and Monitoring Protocol specified in RFC 1305 and enable NTP Mode 6 packets. - - <p>If given no arguments, ntptrace starts with localhost. Here is an example of +</p> +<p>If given no arguments, ntptrace starts with localhost. Here is an example of the output from ntptrace: - -<pre class="example"> % ntptrace localhost: stratum 4, offset 0.0019529, synch distance 0.144135 - server2ozo.com: stratum 2, offset 0.0124263, synch distance 0.115784 usndh.edu: - stratum 1, offset 0.0019298, synch distance 0.011993, refid 'WWVB' -</pre> - <p>On each line, the fields are (left to right): the host name, the host stratum, +</p> +<div class="example"> +<pre class="example">% ntptrace localhost: stratum 4, offset 0.0019529, synch distance 0.144135 +server2ozo.com: stratum 2, offset 0.0124263, synch distance 0.115784 usndh.edu: +stratum 1, offset 0.0019298, synch distance 0.011993, refid 'WWVB' +</pre></div> + +<p>On each line, the fields are (left to right): the host name, the host stratum, the time offset between that host and the local host (as measured by -<code>ntptrace</code>; this is why it is not always zero for "localhost"), the host +<code>ntptrace</code>; this is why it is not always zero for "localhost"), the host synchronization distance, and (only for stratum-1 servers) the reference clock ID. All times are given in seconds. Note that the stratum is the server hop count to the primary source, while the synchronization distance is the estimated error relative to the primary source. These terms are precisely defined in RFC-1305. +</p> - <p>This section was generated by <strong>AutoGen</strong>, +<p>This section was generated by <strong>AutoGen</strong>, using the <code>agtexi-cmd</code> template and the option descriptions for the <code>ntptrace</code> program. - -<ul class="menu"> -<li><a accesskey="1" href="#ntptrace-usage">ntptrace usage</a>: ntptrace help/usage (<span class="option">--help</span>) -<li><a accesskey="2" href="#ntptrace-numeric">ntptrace numeric</a>: numeric option (-n) -<li><a accesskey="3" href="#ntptrace-max_002dhosts">ntptrace max-hosts</a>: max-hosts option (-m) -<li><a accesskey="4" href="#ntptrace-host">ntptrace host</a>: host option (-r) -<li><a accesskey="5" href="#ntptrace-exit-status">ntptrace exit status</a>: exit status -</ul> - -<div class="node"> -<p><hr> -<a name="ntptrace-usage"></a>Next: <a rel="next" accesskey="n" href="#ntptrace-numeric">ntptrace numeric</a>, -Up: <a rel="up" accesskey="u" href="#ntptrace-Invocation">ntptrace Invocation</a> -<br> +</p> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#ntptrace-usage" accesskey="1">ntptrace usage</a>:</td><td> </td><td align="left" valign="top">ntptrace help/usage (<samp>--help</samp>) +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntptrace-numeric" accesskey="2">ntptrace numeric</a>:</td><td> </td><td align="left" valign="top">numeric option (-n) +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntptrace-max_002dhosts" accesskey="3">ntptrace max-hosts</a>:</td><td> </td><td align="left" valign="top">max-hosts option (-m) +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntptrace-host" accesskey="4">ntptrace host</a>:</td><td> </td><td align="left" valign="top">host option (-r) +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntptrace-exit-status" accesskey="5">ntptrace exit status</a>:</td><td> </td><td align="left" valign="top">exit status +</td></tr> +</table> + +<hr> +<a name="ntptrace-usage"></a> +<div class="header"> +<p> +Next: <a href="#ntptrace-numeric" accesskey="n" rel="next">ntptrace numeric</a>, Up: <a href="#ntptrace-Invocation" accesskey="u" rel="up">ntptrace Invocation</a> </p> </div> - -<h4 class="subsection">ntptrace help/usage (<span class="option">--help</span>)</h4> - -<p><a name="index-ntptrace-help-3"></a> -This is the automatically generated usage text for ntptrace. - - <p>The text printed is the same whether selected with the <code>help</code> option -(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print -the usage text by passing it through a pager program. +<a name="ntptrace-help_002fusage-_0028_002d_002dhelp_0029"></a> +<h3 class="section">1.1 ntptrace help/usage (<samp>--help</samp>)</h3> +<a name="index-ntptrace-help"></a> + +<p>This is the automatically generated usage text for ntptrace. +</p> +<p>The text printed is the same whether selected with the <code>help</code> option +(<samp>--help</samp>) or the <code>more-help</code> option (<samp>--more-help</samp>). <code>more-help</code> will print +the usage text by passing it through a pager program. <code>more-help</code> is disabled on platforms without a working <code>fork(2)</code> function. The <code>PAGER</code> environment variable is -used to select the program, defaulting to <span class="file">more</span>. Both will exit +used to select the program, defaulting to <samp>more</samp>. Both will exit with a status code of 0. - -<pre class="example">ntptrace - Trace peers of an NTP server - Ver. 4.2.8p12 +</p> +<div class="example"> +<pre class="example">ntptrace - Trace peers of an NTP server - Ver. 4.2.8p13 USAGE: ntptrace [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [host] -n, --numeric Print IP addresses instead of hostnames @@ -118,63 +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. -</pre> - <div class="node"> -<p><hr> -<a name="ntptrace-numeric"></a>Next: <a rel="next" accesskey="n" href="#ntptrace-max_002dhosts">ntptrace max-hosts</a>, -Previous: <a rel="previous" accesskey="p" href="#ntptrace-usage">ntptrace usage</a>, -Up: <a rel="up" accesskey="u" href="#ntptrace-Invocation">ntptrace Invocation</a> -<br> +</pre></div> + +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#ntptrace-numeric" accesskey="1">ntptrace numeric</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntptrace-max_002dhosts" accesskey="2">ntptrace max-hosts</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntptrace-host" accesskey="3">ntptrace host</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#ntptrace-exit-status" accesskey="4">ntptrace exit status</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +</table> + +<hr> +<a name="ntptrace-numeric"></a> +<div class="header"> +<p> +Next: <a href="#ntptrace-max_002dhosts" accesskey="n" rel="next">ntptrace max-hosts</a>, Previous: <a href="#ntptrace-usage" accesskey="p" rel="prev">ntptrace usage</a>, Up: <a href="#ntptrace-usage" accesskey="u" rel="up">ntptrace usage</a> </p> </div> +<a name="numeric-option-_0028_002dn_0029"></a> +<h4 class="subsection">1.1.1 numeric option (-n)</h4> +<a name="index-ntptrace_002dnumeric"></a> -<h4 class="subsection">numeric option (-n)</h4> - -<p><a name="index-ntptrace_002dnumeric-4"></a> -This is the “print ip addresses instead of hostnames” option. +<p>This is the “print ip addresses instead of hostnames” option. Output hosts as dotted-quad numeric format rather than converting to -the canonical host names. -<div class="node"> -<p><hr> -<a name="ntptrace-max_002dhosts"></a>Next: <a rel="next" accesskey="n" href="#ntptrace-host">ntptrace host</a>, -Previous: <a rel="previous" accesskey="p" href="#ntptrace-numeric">ntptrace numeric</a>, -Up: <a rel="up" accesskey="u" href="#ntptrace-Invocation">ntptrace Invocation</a> -<br> +the canonical host names. +</p><hr> +<a name="ntptrace-max_002dhosts"></a> +<div class="header"> +<p> +Next: <a href="#ntptrace-host" accesskey="n" rel="next">ntptrace host</a>, Previous: <a href="#ntptrace-numeric" accesskey="p" rel="prev">ntptrace numeric</a>, Up: <a href="#ntptrace-usage" accesskey="u" rel="up">ntptrace usage</a> </p> </div> - -<h4 class="subsection">max-hosts option (-m)</h4> - -<p><a name="index-ntptrace_002dmax_002dhosts-5"></a> -This is the “maximum number of peers to trace” option. -This option takes a number argument. -This option has no <span class="samp">doc</span> documentation. -<div class="node"> -<p><hr> -<a name="ntptrace-host"></a>Next: <a rel="next" accesskey="n" href="#ntptrace-exit-status">ntptrace exit status</a>, -Previous: <a rel="previous" accesskey="p" href="#ntptrace-max_002dhosts">ntptrace max-hosts</a>, -Up: <a rel="up" accesskey="u" href="#ntptrace-Invocation">ntptrace Invocation</a> -<br> +<a name="max_002dhosts-option-_0028_002dm_0029"></a> +<h4 class="subsection">1.1.2 max-hosts option (-m)</h4> +<a name="index-ntptrace_002dmax_002dhosts"></a> + +<p>This is the “maximum number of peers to trace” option. +This option takes a number argument. +This option has no ‘<samp>doc</samp>’ documentation. +</p><hr> +<a name="ntptrace-host"></a> +<div class="header"> +<p> +Next: <a href="#ntptrace-exit-status" accesskey="n" rel="next">ntptrace exit status</a>, Previous: <a href="#ntptrace-max_002dhosts" accesskey="p" rel="prev">ntptrace max-hosts</a>, Up: <a href="#ntptrace-usage" accesskey="u" rel="up">ntptrace usage</a> </p> </div> - -<h4 class="subsection">host option (-r)</h4> - -<p><a name="index-ntptrace_002dhost-6"></a> -This is the “single remote host” option. -This option takes a string argument. -This option has no <span class="samp">doc</span> documentation. -<div class="node"> -<p><hr> -<a name="ntptrace-exit-status"></a>Previous: <a rel="previous" accesskey="p" href="#ntptrace-host">ntptrace host</a>, -Up: <a rel="up" accesskey="u" href="#ntptrace-Invocation">ntptrace Invocation</a> -<br> +<a name="host-option-_0028_002dr_0029"></a> +<h4 class="subsection">1.1.3 host option (-r)</h4> +<a name="index-ntptrace_002dhost"></a> + +<p>This is the “single remote host” option. +This option takes a string argument. +This option has no ‘<samp>doc</samp>’ documentation. +</p><hr> +<a name="ntptrace-exit-status"></a> +<div class="header"> +<p> +Previous: <a href="#ntptrace-host" accesskey="p" rel="prev">ntptrace host</a>, Up: <a href="#ntptrace-usage" accesskey="u" rel="up">ntptrace usage</a> </p> </div> - -<h4 class="subsection">ntptrace exit status</h4> +<a name="ntptrace-exit-status-1"></a> +<h4 class="subsection">1.1.4 ntptrace exit status</h4> <p>One of the following exit values will be returned: - <dl> -<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution. -<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid. +</p><dl compact="compact"> +<dt>‘<samp>0 (EXIT_SUCCESS)</samp>’</dt> +<dd><p>Successful program execution. +</p></dd> +<dt>‘<samp>1 (EXIT_FAILURE)</samp>’</dt> +<dd><p>The operation failed or the command syntax was not valid. +</p></dd> </dl> +<hr> + -</body></html> +</body> +</html> diff --git a/contrib/ntp/scripts/ntptrace/ntptrace.man.in b/contrib/ntp/scripts/ntptrace/ntptrace.man.in index fb47716fd8af..2b498a6b7353 100644 --- a/contrib/ntp/scripts/ntptrace/ntptrace.man.in +++ b/contrib/ntp/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@ "14 Aug 2018" "ntp (4.2.8p12)" "User Commands" +.TH ntptrace @NTPTRACE_MS@ "20 Feb 2019" "ntp (4.2.8p13)" "User Commands" .\" -.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-n1aOAe/ag-B1aWze) +.\" EDIT THIS FILE WITH CAUTION (in-mem file) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:22 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 09:57:37 AM by AutoGen 5.18.5 .\" From the definitions ntptrace-opts.def .\" and the template file agman-cmd.tpl .SH NAME diff --git a/contrib/ntp/scripts/ntptrace/ntptrace.mdoc.in b/contrib/ntp/scripts/ntptrace/ntptrace.mdoc.in index 2d02bd81191f..879dcdfbd7e9 100644 --- a/contrib/ntp/scripts/ntptrace/ntptrace.mdoc.in +++ b/contrib/ntp/scripts/ntptrace/ntptrace.mdoc.in @@ -1,9 +1,9 @@ -.Dd August 14 2018 +.Dd February 20 2019 .Dt NTPTRACE @NTPTRACE_MS@ User Commands .Os .\" EDIT THIS FILE WITH CAUTION (ntptrace-opts.mdoc) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:27 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 09:57:35 AM by AutoGen 5.18.5 .\" From the definitions ntptrace-opts.def .\" and the template file agmdoc-cmd.tpl .Sh NAME diff --git a/contrib/ntp/scripts/plot_summary-opts b/contrib/ntp/scripts/plot_summary-opts index 0e2c8ce132de..2e0126277f20 100644 --- a/contrib/ntp/scripts/plot_summary-opts +++ b/contrib/ntp/scripts/plot_summary-opts @@ -1,6 +1,6 @@ # EDIT THIS FILE WITH CAUTION (plot_summary-opts) # -# It has been AutoGen-ed August 14, 2018 at 08:09:38 AM by AutoGen 5.18.5 +# It has been AutoGen-ed February 20, 2019 at 05:04:25 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.8p12 +plot_summary - plot statistics generated by summary script - Ver. 4.2.8p13 USAGE: plot_summary [ -<flag> [<val>] | --<name>[{=| }<val>] ]... --directory=str Where the summary files are diff --git a/contrib/ntp/scripts/plot_summary.1plot_summaryman b/contrib/ntp/scripts/plot_summary.1plot_summaryman index 702742e2212b..d8188c39728c 100644 --- a/contrib/ntp/scripts/plot_summary.1plot_summaryman +++ b/contrib/ntp/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 "14 Aug 2018" "ntp (4.2.8p12)" "User Commands" +.TH plot_summary 1plot_summaryman "20 Feb 2019" "ntp (4.2.8p13)" "User Commands" .\" -.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-_gaOWg/ag-lhaWVg) +.\" EDIT THIS FILE WITH CAUTION (in-mem file) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:43 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 05:04:26 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/contrib/ntp/scripts/plot_summary.1plot_summarymdoc b/contrib/ntp/scripts/plot_summary.1plot_summarymdoc index dc55fc309340..d3a9f7bde125 100644 --- a/contrib/ntp/scripts/plot_summary.1plot_summarymdoc +++ b/contrib/ntp/scripts/plot_summary.1plot_summarymdoc @@ -1,9 +1,9 @@ -.Dd August 14 2018 +.Dd February 20 2019 .Dt PLOT_SUMMARY 1plot_summarymdoc User Commands .Os .\" EDIT THIS FILE WITH CAUTION (plot_summary-opts.mdoc) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:45 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 05:04:27 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/contrib/ntp/scripts/plot_summary.html b/contrib/ntp/scripts/plot_summary.html index 386b75269893..529a761baad9 100644 --- a/contrib/ntp/scripts/plot_summary.html +++ b/contrib/ntp/scripts/plot_summary.html @@ -1,96 +1,138 @@ -<html lang="en"> +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ --> <head> -<title>Plot_summary User's Manual</title> -<meta http-equiv="Content-Type" content="text/html"> -<meta name="description" content="Plot_summary User's Manual"> -<meta name="generator" content="makeinfo 4.7"> -<link title="Top" rel="top" href="#Top"> -<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> -<meta http-equiv="Content-Style-Type" content="text/css"> -<style type="text/css"><!-- - pre.display { font-family:inherit } - pre.format { font-family:inherit } - pre.smalldisplay { font-family:inherit; font-size:smaller } - pre.smallformat { font-family:inherit; font-size:smaller } - pre.smallexample { font-size:smaller } - pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } ---></style> -</head> -<body> -<h1 class="settitle">Plot_summary User's Manual</h1> -<div class="node"> -<p><hr> -<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#plot_005fsummary-Description">plot_summary Description</a>, -Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>, -Up: <a rel="up" accesskey="u" href="#dir">(dir)</a> -<br> -</div> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>Plot_summary User’s Manual</title> + +<meta name="description" content="Plot_summary User’s Manual"> +<meta name="keywords" content="Plot_summary User’s Manual"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<link href="#Top" rel="start" title="Top"> +<link href="dir.html#Top" rel="up" title="(dir)"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +blockquote.smallindentedblock {margin-right: 0em; font-size: smaller} +blockquote.smallquotation {font-size: smaller} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +div.smalldisplay {margin-left: 3.2em} +div.smallexample {margin-left: 3.2em} +div.smalllisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +pre.smalldisplay {font-family: inherit; font-size: smaller} +pre.smallexample {font-size: smaller} +pre.smallformat {font-family: inherit; font-size: smaller} +pre.smalllisp {font-size: smaller} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> -<h2 class="unnumbered">Plot_summary User Manual</h2> -<p>This document describes the use of the NTP Project's <code>plot_summary</code> program. -This document applies to version 4.2.8p12 of <code>plot_summary</code>. +</head> - <div class="shortcontents"> -<h2>Short Contents</h2> -<ul> -<a href="#Top">Plot_summary User Manual</a> -</ul> -</div> +<body lang="en"> +<h1 class="settitle" align="center">Plot_summary User’s Manual</h1> -<ul class="menu"> -<li><a accesskey="1" href="#plot_005fsummary-Description">plot_summary Description</a>: Description -<li><a accesskey="2" href="#plot_005fsummary-Invocation">plot_summary Invocation</a>: Invoking plot_summary -</ul> -<div class="node"> -<p><hr> -<a name="plot_005fsummary-Invocation"></a>Previous: <a rel="previous" accesskey="p" href="#plot_005fsummary-Description">plot_summary Description</a>, -Up: <a rel="up" accesskey="u" href="#Top">Top</a> -<br> -</div> -<h3 class="section">Invoking plot_summary</h3> -<p><a name="index-plot_005fsummary-1"></a><a name="index-plot-statistics-generated-by-summary-script-2"></a> - <p>This section was generated by <strong>AutoGen</strong>, -using the <code>agtexi-cmd</code> template and the option descriptions for the <code>plot_summary</code> program. - -<ul class="menu"> -<li><a accesskey="1" href="#plot_005fsummary-usage">plot_summary usage</a>: plot_summary help/usage (<span class="option">--help</span>) -<li><a accesskey="2" href="#plot_005fsummary-directory">plot_summary directory</a>: directory option -<li><a accesskey="3" href="#plot_005fsummary-identifier">plot_summary identifier</a>: identifier option -<li><a accesskey="4" href="#plot_005fsummary-peer">plot_summary peer</a>: peer option -<li><a accesskey="5" href="#plot_005fsummary-plot_002dterm">plot_summary plot-term</a>: plot-term option -<li><a accesskey="6" href="#plot_005fsummary-output_002dfile">plot_summary output-file</a>: output-file option -<li><a accesskey="7" href="#plot_005fsummary-exit-status">plot_summary exit status</a>: exit status +<a name="Top"></a> +<div class="header"> +<p> +Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> </p> +</div> +<a name="Plot_005fsummary-User-Manual"></a> +<h1 class="top">Plot_summary User Manual</h1> + +<p>This document describes the use of the NTP Project’s <code>plot_summary</code> program. +This document applies to version 4.2.8p13 of <code>plot_summary</code>. +</p> +<a name="SEC_Overview"></a> +<h2 class="shortcontents-heading">Short Table of Contents</h2> + +<div class="shortcontents"> +<ul class="no-bullet"> +<li><a name="stoc-Invoking-plot_005fsummary" href="#toc-Invoking-plot_005fsummary">1 Invoking plot_summary</a></li> </ul> - -<div class="node"> -<p><hr> -<a name="plot_005fsummary-usage"></a>Next: <a rel="next" accesskey="n" href="#plot_005fsummary-directory">plot_summary directory</a>, -Up: <a rel="up" accesskey="u" href="#plot_005fsummary-Invocation">plot_summary Invocation</a> -<br> </div> -<h4 class="subsection">plot_summary help/usage (<span class="option">--help</span>)</h4> -<p><a name="index-plot_005fsummary-help-3"></a> -This is the automatically generated usage text for plot_summary. +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• plot_summary Description:</td><td> </td><td align="left" valign="top">Description +</td></tr> +<tr><td align="left" valign="top">• <a href="#plot_005fsummary-Invocation" accesskey="2">plot_summary Invocation</a>:</td><td> </td><td align="left" valign="top">Invoking plot_summary +</td></tr> +</table> - <p>The text printed is the same whether selected with the <code>help</code> option -(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print -the usage text by passing it through a pager program. +<hr> +<a name="plot_005fsummary-Invocation"></a> +<div class="header"> +<p> +Up: <a href="#Top" accesskey="u" rel="up">Top</a> </p> +</div> +<a name="Invoking-plot_005fsummary"></a> +<h2 class="chapter">1 Invoking plot_summary</h2> +<a name="index-plot_005fsummary"></a> +<a name="index-plot-statistics-generated-by-summary-script"></a> + + +<p>This section was generated by <strong>AutoGen</strong>, +using the <code>agtexi-cmd</code> template and the option descriptions for the <code>plot_summary</code> program. +</p> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#plot_005fsummary-usage" accesskey="1">plot_summary usage</a>:</td><td> </td><td align="left" valign="top">plot_summary help/usage (<samp>--help</samp>) +</td></tr> +<tr><td align="left" valign="top">• <a href="#plot_005fsummary-directory" accesskey="2">plot_summary directory</a>:</td><td> </td><td align="left" valign="top">directory option +</td></tr> +<tr><td align="left" valign="top">• <a href="#plot_005fsummary-identifier" accesskey="3">plot_summary identifier</a>:</td><td> </td><td align="left" valign="top">identifier option +</td></tr> +<tr><td align="left" valign="top">• <a href="#plot_005fsummary-peer" accesskey="4">plot_summary peer</a>:</td><td> </td><td align="left" valign="top">peer option +</td></tr> +<tr><td align="left" valign="top">• <a href="#plot_005fsummary-plot_002dterm" accesskey="5">plot_summary plot-term</a>:</td><td> </td><td align="left" valign="top">plot-term option +</td></tr> +<tr><td align="left" valign="top">• <a href="#plot_005fsummary-output_002dfile" accesskey="6">plot_summary output-file</a>:</td><td> </td><td align="left" valign="top">output-file option +</td></tr> +<tr><td align="left" valign="top">• <a href="#plot_005fsummary-exit-status" accesskey="7">plot_summary exit status</a>:</td><td> </td><td align="left" valign="top">exit status +</td></tr> +</table> + +<hr> +<a name="plot_005fsummary-usage"></a> +<div class="header"> +<p> +Next: <a href="#plot_005fsummary-directory" accesskey="n" rel="next">plot_summary directory</a>, Up: <a href="#plot_005fsummary-Invocation" accesskey="u" rel="up">plot_summary Invocation</a> </p> +</div> +<a name="plot_005fsummary-help_002fusage-_0028_002d_002dhelp_0029"></a> +<h3 class="section">1.1 plot_summary help/usage (<samp>--help</samp>)</h3> +<a name="index-plot_005fsummary-help"></a> + +<p>This is the automatically generated usage text for plot_summary. +</p> +<p>The text printed is the same whether selected with the <code>help</code> option +(<samp>--help</samp>) or the <code>more-help</code> option (<samp>--more-help</samp>). <code>more-help</code> will print +the usage text by passing it through a pager program. <code>more-help</code> is disabled on platforms without a working <code>fork(2)</code> function. The <code>PAGER</code> environment variable is -used to select the program, defaulting to <span class="file">more</span>. Both will exit +used to select the program, defaulting to <samp>more</samp>. Both will exit with a status code of 0. - -<pre class="example">plot_summary - plot statistics generated by summary script - Ver. 4.2.8p12 -USAGE: plot_summary [ -<flag> [<val>] | --<name>[{=| }<val>] ]... +</p> +<div class="example"> +<pre class="example">plot_summary - plot statistics generated by summary script - Ver. 4.2.8p13 +USAGE: plot_summary [ -<flag> [<val>] | --<name>[{=| }<val>] ]... --directory=str Where the summary files are --identifier=str Origin of the data @@ -105,103 +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. -</pre> - <div class="node"> -<p><hr> -<a name="plot_005fsummary-directory"></a>Next: <a rel="next" accesskey="n" href="#plot_005fsummary-identifier">plot_summary identifier</a>, -Previous: <a rel="previous" accesskey="p" href="#plot_005fsummary-usage">plot_summary usage</a>, -Up: <a rel="up" accesskey="u" href="#plot_005fsummary-Invocation">plot_summary Invocation</a> -<br> +</pre></div> + +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#plot_005fsummary-directory" accesskey="1">plot_summary directory</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#plot_005fsummary-identifier" accesskey="2">plot_summary identifier</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#plot_005fsummary-peer" accesskey="3">plot_summary peer</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#plot_005fsummary-plot_002dterm" accesskey="4">plot_summary plot-term</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#plot_005fsummary-output_002dfile" accesskey="5">plot_summary output-file</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#plot_005fsummary-exit-status" accesskey="6">plot_summary exit status</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +</table> + +<hr> +<a name="plot_005fsummary-directory"></a> +<div class="header"> +<p> +Next: <a href="#plot_005fsummary-identifier" accesskey="n" rel="next">plot_summary identifier</a>, Previous: <a href="#plot_005fsummary-usage" accesskey="p" rel="prev">plot_summary usage</a>, Up: <a href="#plot_005fsummary-usage" accesskey="u" rel="up">plot_summary usage</a> </p> </div> +<a name="directory-option"></a> +<h4 class="subsection">1.1.1 directory option</h4> +<a name="index-plot_005fsummary_002ddirectory"></a> -<h4 class="subsection">directory option</h4> - -<p><a name="index-plot_005fsummary_002ddirectory-4"></a> -This is the “where the summary files are” option. -This option takes a string argument. +<p>This is the “where the summary files are” option. +This option takes a string argument. The directory where the <code>plot_summary</code> will search for the - *_summary files generated by <code>summary</code> script. -<div class="node"> -<p><hr> -<a name="plot_005fsummary-identifier"></a>Next: <a rel="next" accesskey="n" href="#plot_005fsummary-peer">plot_summary peer</a>, -Previous: <a rel="previous" accesskey="p" href="#plot_005fsummary-directory">plot_summary directory</a>, -Up: <a rel="up" accesskey="u" href="#plot_005fsummary-Invocation">plot_summary Invocation</a> -<br> + *_summary files generated by <code>summary</code> script. +</p><hr> +<a name="plot_005fsummary-identifier"></a> +<div class="header"> +<p> +Next: <a href="#plot_005fsummary-peer" accesskey="n" rel="next">plot_summary peer</a>, Previous: <a href="#plot_005fsummary-directory" accesskey="p" rel="prev">plot_summary directory</a>, Up: <a href="#plot_005fsummary-usage" accesskey="u" rel="up">plot_summary usage</a> </p> </div> +<a name="identifier-option"></a> +<h4 class="subsection">1.1.2 identifier option</h4> +<a name="index-plot_005fsummary_002didentifier"></a> -<h4 class="subsection">identifier option</h4> - -<p><a name="index-plot_005fsummary_002didentifier-5"></a> -This is the “origin of the data” option. -This option takes a string argument. - Where does the plotted data come from, default to string "host" plus +<p>This is the “origin of the data” option. +This option takes a string argument. + Where does the plotted data come from, default to string "host" plus current hostname -<div class="node"> -<p><hr> -<a name="plot_005fsummary-peer"></a>Next: <a rel="next" accesskey="n" href="#plot_005fsummary-plot_002dterm">plot_summary plot-term</a>, -Previous: <a rel="previous" accesskey="p" href="#plot_005fsummary-identifier">plot_summary identifier</a>, -Up: <a rel="up" accesskey="u" href="#plot_005fsummary-Invocation">plot_summary Invocation</a> -<br> +</p><hr> +<a name="plot_005fsummary-peer"></a> +<div class="header"> +<p> +Next: <a href="#plot_005fsummary-plot_002dterm" accesskey="n" rel="next">plot_summary plot-term</a>, Previous: <a href="#plot_005fsummary-identifier" accesskey="p" rel="prev">plot_summary identifier</a>, Up: <a href="#plot_005fsummary-usage" accesskey="u" rel="up">plot_summary usage</a> </p> </div> +<a name="peer-option"></a> +<h4 class="subsection">1.1.3 peer option</h4> +<a name="index-plot_005fsummary_002dpeer"></a> -<h4 class="subsection">peer option</h4> - -<p><a name="index-plot_005fsummary_002dpeer-6"></a> -This is the “peers to generate plots for” option. +<p>This is the “peers to generate plots for” option. This option takes a string argument. - -<p class="noindent">This option has some usage constraints. It: - <ul> -<li>may appear an unlimited number of times. -</ul> - - <p>By default the peer_summary plots are not generated. Use this option to - specify list of peers if you want to generate plots for them. -<div class="node"> -<p><hr> -<a name="plot_005fsummary-plot_002dterm"></a>Next: <a rel="next" accesskey="n" href="#plot_005fsummary-output_002dfile">plot_summary output-file</a>, -Previous: <a rel="previous" accesskey="p" href="#plot_005fsummary-peer">plot_summary peer</a>, -Up: <a rel="up" accesskey="u" href="#plot_005fsummary-Invocation">plot_summary Invocation</a> -<br> +</p> +<p>This option has some usage constraints. It: +</p><ul> +<li> may appear an unlimited number of times. +</li></ul> + +<p>By default the peer_summary plots are not generated. Use this option to + specify list of peers if you want to generate plots for them. +</p><hr> +<a name="plot_005fsummary-plot_002dterm"></a> +<div class="header"> +<p> +Next: <a href="#plot_005fsummary-output_002dfile" accesskey="n" rel="next">plot_summary output-file</a>, Previous: <a href="#plot_005fsummary-peer" accesskey="p" rel="prev">plot_summary peer</a>, Up: <a href="#plot_005fsummary-usage" accesskey="u" rel="up">plot_summary usage</a> </p> </div> +<a name="plot_002dterm-option"></a> +<h4 class="subsection">1.1.4 plot-term option</h4> +<a name="index-plot_005fsummary_002dplot_002dterm"></a> -<h4 class="subsection">plot-term option</h4> - -<p><a name="index-plot_005fsummary_002dplot_002dterm-7"></a> -This is the “gnuplot terminal” option. -This option takes a string argument. +<p>This is the “gnuplot terminal” option. +This option takes a string argument. This is string is passed directly to the <code>gnuplot set terminal</code> command. Default is <code>x11</code> if <code>DISPLAY</code> is set and - <code>dumb</code> is it's not'. See output from -e "set - terminal") for the list of available options. -<div class="node"> -<p><hr> -<a name="plot_005fsummary-output_002dfile"></a>Next: <a rel="next" accesskey="n" href="#plot_005fsummary-exit-status">plot_summary exit status</a>, -Previous: <a rel="previous" accesskey="p" href="#plot_005fsummary-plot_002dterm">plot_summary plot-term</a>, -Up: <a rel="up" accesskey="u" href="#plot_005fsummary-Invocation">plot_summary Invocation</a> -<br> + <code>dumb</code> is it’s not’. See output from (gnuplot -e "set + terminal") for the list of available options. +</p><hr> +<a name="plot_005fsummary-output_002dfile"></a> +<div class="header"> +<p> +Next: <a href="#plot_005fsummary-exit-status" accesskey="n" rel="next">plot_summary exit status</a>, Previous: <a href="#plot_005fsummary-plot_002dterm" accesskey="p" rel="prev">plot_summary plot-term</a>, Up: <a href="#plot_005fsummary-usage" accesskey="u" rel="up">plot_summary usage</a> </p> </div> - -<h4 class="subsection">output-file option</h4> - -<p><a name="index-plot_005fsummary_002doutput_002dfile-8"></a> -This is the “output file” option. -This option takes a str argument. - Output file for <code>gnuplot</code>, default to stdout. -<div class="node"> -<p><hr> -<a name="plot_005fsummary-exit-status"></a>Previous: <a rel="previous" accesskey="p" href="#plot_005fsummary-output_002dfile">plot_summary output-file</a>, -Up: <a rel="up" accesskey="u" href="#plot_005fsummary-Invocation">plot_summary Invocation</a> -<br> +<a name="output_002dfile-option"></a> +<h4 class="subsection">1.1.5 output-file option</h4> +<a name="index-plot_005fsummary_002doutput_002dfile"></a> + +<p>This is the “output file” option. +This option takes a str argument. + Output file for <code>gnuplot</code>, default to stdout. +</p><hr> +<a name="plot_005fsummary-exit-status"></a> +<div class="header"> +<p> +Previous: <a href="#plot_005fsummary-output_002dfile" accesskey="p" rel="prev">plot_summary output-file</a>, Up: <a href="#plot_005fsummary-usage" accesskey="u" rel="up">plot_summary usage</a> </p> </div> - -<h4 class="subsection">plot_summary exit status</h4> +<a name="plot_005fsummary-exit-status-1"></a> +<h4 class="subsection">1.1.6 plot_summary exit status</h4> <p>One of the following exit values will be returned: - <dl> -<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution. -<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid. +</p><dl compact="compact"> +<dt>‘<samp>0 (EXIT_SUCCESS)</samp>’</dt> +<dd><p>Successful program execution. +</p></dd> +<dt>‘<samp>1 (EXIT_FAILURE)</samp>’</dt> +<dd><p>The operation failed or the command syntax was not valid. +</p></dd> </dl> +<hr> + -</body></html> +</body> +</html> diff --git a/contrib/ntp/scripts/plot_summary.man.in b/contrib/ntp/scripts/plot_summary.man.in index 702742e2212b..d8188c39728c 100644 --- a/contrib/ntp/scripts/plot_summary.man.in +++ b/contrib/ntp/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 "14 Aug 2018" "ntp (4.2.8p12)" "User Commands" +.TH plot_summary 1plot_summaryman "20 Feb 2019" "ntp (4.2.8p13)" "User Commands" .\" -.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-_gaOWg/ag-lhaWVg) +.\" EDIT THIS FILE WITH CAUTION (in-mem file) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:43 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 05:04:26 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/contrib/ntp/scripts/plot_summary.mdoc.in b/contrib/ntp/scripts/plot_summary.mdoc.in index dc55fc309340..d3a9f7bde125 100644 --- a/contrib/ntp/scripts/plot_summary.mdoc.in +++ b/contrib/ntp/scripts/plot_summary.mdoc.in @@ -1,9 +1,9 @@ -.Dd August 14 2018 +.Dd February 20 2019 .Dt PLOT_SUMMARY 1plot_summarymdoc User Commands .Os .\" EDIT THIS FILE WITH CAUTION (plot_summary-opts.mdoc) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:45 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 05:04:27 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/contrib/ntp/scripts/summary-opts b/contrib/ntp/scripts/summary-opts index 59869ebc7fc0..9c3102f3aa6b 100644 --- a/contrib/ntp/scripts/summary-opts +++ b/contrib/ntp/scripts/summary-opts @@ -1,6 +1,6 @@ # EDIT THIS FILE WITH CAUTION (summary-opts) # -# It has been AutoGen-ed August 14, 2018 at 08:09:40 AM by AutoGen 5.18.5 +# It has been AutoGen-ed February 20, 2019 at 05:04:25 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.8p12 +summary - compute various stastics from NTP stat files - Ver. 4.2.8p13 USAGE: summary [ -<flag> [<val>] | --<name>[{=| }<val>] ]... --directory=str Directory containing stat files diff --git a/contrib/ntp/scripts/summary.1summaryman b/contrib/ntp/scripts/summary.1summaryman index 4065dd6dd605..932c498a7cd9 100644 --- a/contrib/ntp/scripts/summary.1summaryman +++ b/contrib/ntp/scripts/summary.1summaryman @@ -10,11 +10,11 @@ .ds B-Font B .ds I-Font I .ds R-Font R -.TH summary 1summaryman "14 Aug 2018" "ntp (4.2.8p12)" "User Commands" +.TH summary 1summaryman "20 Feb 2019" "ntp (4.2.8p13)" "User Commands" .\" -.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-tCaq.g/ag-FCay9g) +.\" EDIT THIS FILE WITH CAUTION (in-mem file) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:49 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 05:04:30 PM by AutoGen 5.18.5 .\" From the definitions summary-opts.def .\" and the template file agman-cmd.tpl .SH NAME diff --git a/contrib/ntp/scripts/summary.1summarymdoc b/contrib/ntp/scripts/summary.1summarymdoc index 9bad4df0916b..198d162625bb 100644 --- a/contrib/ntp/scripts/summary.1summarymdoc +++ b/contrib/ntp/scripts/summary.1summarymdoc @@ -1,9 +1,9 @@ -.Dd August 14 2018 +.Dd February 20 2019 .Dt SUMMARY 1summarymdoc User Commands .Os .\" EDIT THIS FILE WITH CAUTION (summary-opts.mdoc) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:51 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 05:04:31 PM by AutoGen 5.18.5 .\" From the definitions summary-opts.def .\" and the template file agmdoc-cmd.tpl .Sh NAME diff --git a/contrib/ntp/scripts/summary.html b/contrib/ntp/scripts/summary.html index 55e0ca90c58f..b6e47e19d762 100644 --- a/contrib/ntp/scripts/summary.html +++ b/contrib/ntp/scripts/summary.html @@ -1,95 +1,138 @@ -<html lang="en"> +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ --> <head> -<title>Summary User's Manual</title> -<meta http-equiv="Content-Type" content="text/html"> -<meta name="description" content="Summary User's Manual"> -<meta name="generator" content="makeinfo 4.7"> -<link title="Top" rel="top" href="#Top"> -<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> -<meta http-equiv="Content-Style-Type" content="text/css"> -<style type="text/css"><!-- - pre.display { font-family:inherit } - pre.format { font-family:inherit } - pre.smalldisplay { font-family:inherit; font-size:smaller } - pre.smallformat { font-family:inherit; font-size:smaller } - pre.smallexample { font-size:smaller } - pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } ---></style> -</head> -<body> -<h1 class="settitle">Summary User's Manual</h1> -<div class="node"> -<p><hr> -<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#summary-Description">summary Description</a>, -Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>, -Up: <a rel="up" accesskey="u" href="#dir">(dir)</a> -<br> -</div> - -<h2 class="unnumbered">Summary User Manual</h2> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>Summary User’s Manual</title> + +<meta name="description" content="Summary User’s Manual"> +<meta name="keywords" content="Summary User’s Manual"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<link href="#Top" rel="start" title="Top"> +<link href="dir.html#Top" rel="up" title="(dir)"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +blockquote.smallindentedblock {margin-right: 0em; font-size: smaller} +blockquote.smallquotation {font-size: smaller} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +div.smalldisplay {margin-left: 3.2em} +div.smallexample {margin-left: 3.2em} +div.smalllisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +pre.smalldisplay {font-family: inherit; font-size: smaller} +pre.smallexample {font-size: smaller} +pre.smallformat {font-family: inherit; font-size: smaller} +pre.smalllisp {font-size: smaller} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> -<p>This document describes the use of the NTP Project's <code>summary</code> program. -This document applies to version 4.2.8p12 of <code>summary</code>. - <div class="shortcontents"> -<h2>Short Contents</h2> -<ul> -<a href="#Top">Summary User Manual</a> -</ul> -</div> +</head> -<ul class="menu"> -<li><a accesskey="1" href="#summary-Description">summary Description</a>: Description -<li><a accesskey="2" href="#summary-Invocation">summary Invocation</a>: Invoking summary -</ul> +<body lang="en"> +<h1 class="settitle" align="center">Summary User’s Manual</h1> -<div class="node"> -<p><hr> -<a name="summary-Invocation"></a>Previous: <a rel="previous" accesskey="p" href="#summary-Description">summary Description</a>, -Up: <a rel="up" accesskey="u" href="#Top">Top</a> -<br> -</div> -<h3 class="section">Invoking summary</h3> -<p><a name="index-summary-1"></a><a name="index-compute-various-stastics-from-NTP-stat-files-2"></a> - <p>This section was generated by <strong>AutoGen</strong>, -using the <code>agtexi-cmd</code> template and the option descriptions for the <code>summary</code> program. -<ul class="menu"> -<li><a accesskey="1" href="#summary-usage">summary usage</a>: summary help/usage (<span class="option">--help</span>) -<li><a accesskey="2" href="#summary-directory">summary directory</a>: directory option -<li><a accesskey="3" href="#summary-end_002ddate">summary end-date</a>: end-date option -<li><a accesskey="4" href="#summary-output_002ddirectory">summary output-directory</a>: output-directory option -<li><a accesskey="5" href="#summary-start_002ddate">summary start-date</a>: start-date option -<li><a accesskey="6" href="#summary-exit-status">summary exit status</a>: exit status +<a name="Top"></a> +<div class="header"> +<p> +Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> </p> +</div> +<a name="Summary-User-Manual"></a> +<h1 class="top">Summary User Manual</h1> + +<p>This document describes the use of the NTP Project’s <code>summary</code> program. +This document applies to version 4.2.8p13 of <code>summary</code>. +</p> +<a name="SEC_Overview"></a> +<h2 class="shortcontents-heading">Short Table of Contents</h2> + +<div class="shortcontents"> +<ul class="no-bullet"> +<li><a name="stoc-Invoking-summary" href="#toc-Invoking-summary">1 Invoking summary</a></li> </ul> +</div> + -<div class="node"> -<p><hr> -<a name="summary-usage"></a>Next: <a rel="next" accesskey="n" href="#summary-directory">summary directory</a>, -Up: <a rel="up" accesskey="u" href="#summary-Invocation">summary Invocation</a> -<br> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• summary Description:</td><td> </td><td align="left" valign="top">Description +</td></tr> +<tr><td align="left" valign="top">• <a href="#summary-Invocation" accesskey="2">summary Invocation</a>:</td><td> </td><td align="left" valign="top">Invoking summary +</td></tr> +</table> + +<hr> +<a name="summary-Invocation"></a> +<div class="header"> +<p> +Up: <a href="#Top" accesskey="u" rel="up">Top</a> </p> </div> +<a name="Invoking-summary"></a> +<h2 class="chapter">1 Invoking summary</h2> +<a name="index-summary"></a> +<a name="index-compute-various-stastics-from-NTP-stat-files"></a> + -<h4 class="subsection">summary help/usage (<span class="option">--help</span>)</h4> -<p><a name="index-summary-help-3"></a> -This is the automatically generated usage text for summary. - <p>The text printed is the same whether selected with the <code>help</code> option -(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print -the usage text by passing it through a pager program. +<p>This section was generated by <strong>AutoGen</strong>, +using the <code>agtexi-cmd</code> template and the option descriptions for the <code>summary</code> program. +</p> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#summary-usage" accesskey="1">summary usage</a>:</td><td> </td><td align="left" valign="top">summary help/usage (<samp>--help</samp>) +</td></tr> +<tr><td align="left" valign="top">• <a href="#summary-directory" accesskey="2">summary directory</a>:</td><td> </td><td align="left" valign="top">directory option +</td></tr> +<tr><td align="left" valign="top">• <a href="#summary-end_002ddate" accesskey="3">summary end-date</a>:</td><td> </td><td align="left" valign="top">end-date option +</td></tr> +<tr><td align="left" valign="top">• <a href="#summary-output_002ddirectory" accesskey="4">summary output-directory</a>:</td><td> </td><td align="left" valign="top">output-directory option +</td></tr> +<tr><td align="left" valign="top">• <a href="#summary-start_002ddate" accesskey="5">summary start-date</a>:</td><td> </td><td align="left" valign="top">start-date option +</td></tr> +<tr><td align="left" valign="top">• <a href="#summary-exit-status" accesskey="6">summary exit status</a>:</td><td> </td><td align="left" valign="top">exit status +</td></tr> +</table> + +<hr> +<a name="summary-usage"></a> +<div class="header"> +<p> +Next: <a href="#summary-directory" accesskey="n" rel="next">summary directory</a>, Up: <a href="#summary-Invocation" accesskey="u" rel="up">summary Invocation</a> </p> +</div> +<a name="summary-help_002fusage-_0028_002d_002dhelp_0029"></a> +<h3 class="section">1.1 summary help/usage (<samp>--help</samp>)</h3> +<a name="index-summary-help"></a> + +<p>This is the automatically generated usage text for summary. +</p> +<p>The text printed is the same whether selected with the <code>help</code> option +(<samp>--help</samp>) or the <code>more-help</code> option (<samp>--more-help</samp>). <code>more-help</code> will print +the usage text by passing it through a pager program. <code>more-help</code> is disabled on platforms without a working <code>fork(2)</code> function. The <code>PAGER</code> environment variable is -used to select the program, defaulting to <span class="file">more</span>. Both will exit +used to select the program, defaulting to <samp>more</samp>. Both will exit with a status code of 0. - -<pre class="example">summary - compute various stastics from NTP stat files - Ver. 4.2.8p12 -USAGE: summary [ -<flag> [<val>] | --<name>[{=| }<val>] ]... +</p> +<div class="example"> +<pre class="example">summary - compute various stastics from NTP stat files - Ver. 4.2.8p13 +USAGE: summary [ -<flag> [<val>] | --<name>[{=| }<val>] ]... --directory=str Directory containing stat files --end-date=num End date @@ -102,81 +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. -</pre> - <div class="node"> -<p><hr> -<a name="summary-directory"></a>Next: <a rel="next" accesskey="n" href="#summary-end_002ddate">summary end-date</a>, -Previous: <a rel="previous" accesskey="p" href="#summary-usage">summary usage</a>, -Up: <a rel="up" accesskey="u" href="#summary-Invocation">summary Invocation</a> -<br> +</pre></div> + +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#summary-directory" accesskey="1">summary directory</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#summary-end_002ddate" accesskey="2">summary end-date</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#summary-output_002ddirectory" accesskey="3">summary output-directory</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#summary-start_002ddate" accesskey="4">summary start-date</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#summary-exit-status" accesskey="5">summary exit status</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +</table> + +<hr> +<a name="summary-directory"></a> +<div class="header"> +<p> +Next: <a href="#summary-end_002ddate" accesskey="n" rel="next">summary end-date</a>, Previous: <a href="#summary-usage" accesskey="p" rel="prev">summary usage</a>, Up: <a href="#summary-usage" accesskey="u" rel="up">summary usage</a> </p> </div> +<a name="directory-option"></a> +<h4 class="subsection">1.1.1 directory option</h4> +<a name="index-summary_002ddirectory"></a> -<h4 class="subsection">directory option</h4> - -<p><a name="index-summary_002ddirectory-4"></a> -This is the “directory containing stat files” option. -This option takes a string argument. +<p>This is the “directory containing stat files” option. +This option takes a string argument. The directory where <code>ntpd</code> will search for .stat files generated - by <code>ntpd</code>. -<div class="node"> -<p><hr> -<a name="summary-end_002ddate"></a>Next: <a rel="next" accesskey="n" href="#summary-output_002ddirectory">summary output-directory</a>, -Previous: <a rel="previous" accesskey="p" href="#summary-directory">summary directory</a>, -Up: <a rel="up" accesskey="u" href="#summary-Invocation">summary Invocation</a> -<br> + by <code>ntpd</code>. +</p><hr> +<a name="summary-end_002ddate"></a> +<div class="header"> +<p> +Next: <a href="#summary-output_002ddirectory" accesskey="n" rel="next">summary output-directory</a>, Previous: <a href="#summary-directory" accesskey="p" rel="prev">summary directory</a>, Up: <a href="#summary-usage" accesskey="u" rel="up">summary usage</a> </p> </div> +<a name="end_002ddate-option"></a> +<h4 class="subsection">1.1.2 end-date option</h4> +<a name="index-summary_002dend_002ddate"></a> -<h4 class="subsection">end-date option</h4> - -<p><a name="index-summary_002dend_002ddate-5"></a> -This is the “end date” option. -This option takes a number argument. +<p>This is the “end date” option. +This option takes a number argument. Process all files with the date suffix less or equal to value of this option. Defaults to today minus one day (Use <code>date -u +%Y%m%d</code>) - to get the timestamp. -<div class="node"> -<p><hr> -<a name="summary-output_002ddirectory"></a>Next: <a rel="next" accesskey="n" href="#summary-start_002ddate">summary start-date</a>, -Previous: <a rel="previous" accesskey="p" href="#summary-end_002ddate">summary end-date</a>, -Up: <a rel="up" accesskey="u" href="#summary-Invocation">summary Invocation</a> -<br> + to get the timestamp. +</p><hr> +<a name="summary-output_002ddirectory"></a> +<div class="header"> +<p> +Next: <a href="#summary-start_002ddate" accesskey="n" rel="next">summary start-date</a>, Previous: <a href="#summary-end_002ddate" accesskey="p" rel="prev">summary end-date</a>, Up: <a href="#summary-usage" accesskey="u" rel="up">summary usage</a> </p> </div> - -<h4 class="subsection">output-directory option</h4> - -<p><a name="index-summary_002doutput_002ddirectory-6"></a> -This is the “output directory” option. -This option takes a str argument. - The output directory <code>summary</code> will write all output files to. -<div class="node"> -<p><hr> -<a name="summary-start_002ddate"></a>Next: <a rel="next" accesskey="n" href="#summary-exit-status">summary exit status</a>, -Previous: <a rel="previous" accesskey="p" href="#summary-output_002ddirectory">summary output-directory</a>, -Up: <a rel="up" accesskey="u" href="#summary-Invocation">summary Invocation</a> -<br> +<a name="output_002ddirectory-option"></a> +<h4 class="subsection">1.1.3 output-directory option</h4> +<a name="index-summary_002doutput_002ddirectory"></a> + +<p>This is the “output directory” option. +This option takes a str argument. + The output directory <code>summary</code> will write all output files to. +</p><hr> +<a name="summary-start_002ddate"></a> +<div class="header"> +<p> +Next: <a href="#summary-exit-status" accesskey="n" rel="next">summary exit status</a>, Previous: <a href="#summary-output_002ddirectory" accesskey="p" rel="prev">summary output-directory</a>, Up: <a href="#summary-usage" accesskey="u" rel="up">summary usage</a> </p> </div> +<a name="start_002ddate-option"></a> +<h4 class="subsection">1.1.4 start-date option</h4> +<a name="index-summary_002dstart_002ddate"></a> -<h4 class="subsection">start-date option</h4> - -<p><a name="index-summary_002dstart_002ddate-7"></a> -This is the “start date” option. -This option takes a num argument. +<p>This is the “start date” option. +This option takes a num argument. Process all files with the date suffix more or equal to value of - this option. Defaults to 197000101. -<div class="node"> -<p><hr> -<a name="summary-exit-status"></a>Previous: <a rel="previous" accesskey="p" href="#summary-start_002ddate">summary start-date</a>, -Up: <a rel="up" accesskey="u" href="#summary-Invocation">summary Invocation</a> -<br> + this option. Defaults to 197000101. +</p><hr> +<a name="summary-exit-status"></a> +<div class="header"> +<p> +Previous: <a href="#summary-start_002ddate" accesskey="p" rel="prev">summary start-date</a>, Up: <a href="#summary-usage" accesskey="u" rel="up">summary usage</a> </p> </div> - -<h4 class="subsection">summary exit status</h4> +<a name="summary-exit-status-1"></a> +<h4 class="subsection">1.1.5 summary exit status</h4> <p>One of the following exit values will be returned: - <dl> -<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution. -<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid. +</p><dl compact="compact"> +<dt>‘<samp>0 (EXIT_SUCCESS)</samp>’</dt> +<dd><p>Successful program execution. +</p></dd> +<dt>‘<samp>1 (EXIT_FAILURE)</samp>’</dt> +<dd><p>The operation failed or the command syntax was not valid. +</p></dd> </dl> +<hr> + -</body></html> +</body> +</html> diff --git a/contrib/ntp/scripts/summary.man.in b/contrib/ntp/scripts/summary.man.in index 4065dd6dd605..932c498a7cd9 100644 --- a/contrib/ntp/scripts/summary.man.in +++ b/contrib/ntp/scripts/summary.man.in @@ -10,11 +10,11 @@ .ds B-Font B .ds I-Font I .ds R-Font R -.TH summary 1summaryman "14 Aug 2018" "ntp (4.2.8p12)" "User Commands" +.TH summary 1summaryman "20 Feb 2019" "ntp (4.2.8p13)" "User Commands" .\" -.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-tCaq.g/ag-FCay9g) +.\" EDIT THIS FILE WITH CAUTION (in-mem file) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:49 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 05:04:30 PM by AutoGen 5.18.5 .\" From the definitions summary-opts.def .\" and the template file agman-cmd.tpl .SH NAME diff --git a/contrib/ntp/scripts/summary.mdoc.in b/contrib/ntp/scripts/summary.mdoc.in index 9bad4df0916b..198d162625bb 100644 --- a/contrib/ntp/scripts/summary.mdoc.in +++ b/contrib/ntp/scripts/summary.mdoc.in @@ -1,9 +1,9 @@ -.Dd August 14 2018 +.Dd February 20 2019 .Dt SUMMARY 1summarymdoc User Commands .Os .\" EDIT THIS FILE WITH CAUTION (summary-opts.mdoc) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:51 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 05:04:31 PM by AutoGen 5.18.5 .\" From the definitions summary-opts.def .\" and the template file agmdoc-cmd.tpl .Sh NAME diff --git a/contrib/ntp/scripts/update-leap/Makefile.in b/contrib/ntp/scripts/update-leap/Makefile.in index 3a42d80553bf..3302eee29609 100644 --- a/contrib/ntp/scripts/update-leap/Makefile.in +++ b/contrib/ntp/scripts/update-leap/Makefile.in @@ -1,7 +1,7 @@ -# Makefile.in generated by automake 1.15 from Makefile.am. +# Makefile.in generated by automake 1.15.1 from Makefile.am. # @configure_input@ -# Copyright (C) 1994-2014 Free Software Foundation, Inc. +# Copyright (C) 1994-2017 Free Software Foundation, Inc. # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, diff --git a/contrib/ntp/scripts/update-leap/invoke-update-leap.texi b/contrib/ntp/scripts/update-leap/invoke-update-leap.texi index 6da23f2d1d4c..0d0fbbe89880 100644 --- a/contrib/ntp/scripts/update-leap/invoke-update-leap.texi +++ b/contrib/ntp/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 August 14, 2018 at 08:09:32 AM by AutoGen 5.18.5 +# It has been AutoGen-ed February 20, 2019 at 05:04:22 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/contrib/ntp/scripts/update-leap/update-leap-opts b/contrib/ntp/scripts/update-leap/update-leap-opts index b2f89bf49775..6074aa7a1639 100644 --- a/contrib/ntp/scripts/update-leap/update-leap-opts +++ b/contrib/ntp/scripts/update-leap/update-leap-opts @@ -1,6 +1,6 @@ # EDIT THIS FILE WITH CAUTION (update-leap-opts) # -# It has been AutoGen-ed August 14, 2018 at 08:09:38 AM by AutoGen 5.18.5 +# It has been AutoGen-ed February 20, 2019 at 05:04:25 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.8p12 +update-leap - leap-seconds file manager/updater - Ver. 4.2.8p13 USAGE: update-leap [ -<flag> [<val>] | --<name>[{=| }<val>] ]... -s, --source-url=str The URL of the master copy of the leapseconds file diff --git a/contrib/ntp/scripts/update-leap/update-leap.1update-leapman b/contrib/ntp/scripts/update-leap/update-leap.1update-leapman index ac138146ed81..33aa4f66538f 100644 --- a/contrib/ntp/scripts/update-leap/update-leap.1update-leapman +++ b/contrib/ntp/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 "14 Aug 2018" "ntp (4.2.8p12)" "User Commands" +.TH update-leap 1update-leapman "20 Feb 2019" "ntp (4.2.8p13)" "User Commands" .\" -.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-4Iayif/ag-fJaGhf) +.\" EDIT THIS FILE WITH CAUTION (in-mem file) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:29 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 05:04:24 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/contrib/ntp/scripts/update-leap/update-leap.1update-leapmdoc b/contrib/ntp/scripts/update-leap/update-leap.1update-leapmdoc index e3845dcc3849..fe1a164720c0 100644 --- a/contrib/ntp/scripts/update-leap/update-leap.1update-leapmdoc +++ b/contrib/ntp/scripts/update-leap/update-leap.1update-leapmdoc @@ -1,9 +1,9 @@ -.Dd August 14 2018 +.Dd February 20 2019 .Dt UPDATE_LEAP 1update-leapmdoc User Commands .Os .\" EDIT THIS FILE WITH CAUTION (update-leap-opts.mdoc) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:36 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 09:57:38 AM by AutoGen 5.18.5 .\" From the definitions update-leap-opts.def .\" and the template file agmdoc-cmd.tpl .Sh NAME diff --git a/contrib/ntp/scripts/update-leap/update-leap.html b/contrib/ntp/scripts/update-leap/update-leap.html index 3a05b038a059..becb66888b74 100644 --- a/contrib/ntp/scripts/update-leap/update-leap.html +++ b/contrib/ntp/scripts/update-leap/update-leap.html @@ -1,120 +1,169 @@ -<html lang="en"> +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ --> <head> -<title>update-leap User's Manual</title> -<meta http-equiv="Content-Type" content="text/html"> -<meta name="description" content="update-leap User's Manual"> -<meta name="generator" content="makeinfo 4.7"> -<link title="Top" rel="top" href="#Top"> -<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> -<meta http-equiv="Content-Style-Type" content="text/css"> -<style type="text/css"><!-- - pre.display { font-family:inherit } - pre.format { font-family:inherit } - pre.smalldisplay { font-family:inherit; font-size:smaller } - pre.smallformat { font-family:inherit; font-size:smaller } - pre.smallexample { font-size:smaller } - pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } ---></style> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>update-leap User’s Manual</title> + +<meta name="description" content="update-leap User’s Manual"> +<meta name="keywords" content="update-leap User’s Manual"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<link href="#Top" rel="start" title="Top"> +<link href="dir.html#Top" rel="up" title="(dir)"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +blockquote.smallindentedblock {margin-right: 0em; font-size: smaller} +blockquote.smallquotation {font-size: smaller} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +div.smalldisplay {margin-left: 3.2em} +div.smallexample {margin-left: 3.2em} +div.smalllisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +pre.smalldisplay {font-family: inherit; font-size: smaller} +pre.smallexample {font-size: smaller} +pre.smallformat {font-family: inherit; font-size: smaller} +pre.smalllisp {font-size: smaller} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + + </head> -<body> -<h1 class="settitle">update-leap User's Manual</h1> -<div class="node"> -<p><hr> -<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-Description">update-leap Description</a>, -Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>, -Up: <a rel="up" accesskey="u" href="#dir">(dir)</a> -<br> -</div> - <p>This document describes the use of the NTP Project's <code>update-leap</code> program. +<body lang="en"> +<h1 class="settitle" align="center">update-leap User’s Manual</h1> + + - <p>This document applies to version 4.2.8p12 of <code>update-leap</code>. + + +<a name="Top"></a> +<div class="header"> +<p> +Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> </p> +</div> +<h1 class="node-heading">Top</h1> + +<p>This document describes the use of the NTP Project’s <code>update-leap</code> program. +</p> +<p>This document applies to version 4.2.8p13 of <code>update-leap</code>. +</p> +<a name="SEC_Overview"></a> +<h2 class="shortcontents-heading">Short Table of Contents</h2> <div class="shortcontents"> -<h2>Short Contents</h2> -<ul> -</ul> +<li><a name="stoc-Invoking-update_002dleap" href="#toc-Invoking-update_002dleap">1 Invoking update-leap</a></li> + </div> -<ul class="menu"> -<li><a accesskey="1" href="#update_002dleap-Description">update-leap Description</a>: Description -<li><a accesskey="2" href="#update_002dleap-Invocation">update-leap Invocation</a>: Invoking update-leap -</ul> -<div class="node"> -<p><hr> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• update-leap Description:</td><td> </td><td align="left" valign="top">Description +</td></tr> +<tr><td align="left" valign="top">• <a href="#update_002dleap-Invocation" accesskey="2">update-leap Invocation</a>:</td><td> </td><td align="left" valign="top">Invoking update-leap +</td></tr> +</table> + +<hr> <a name="update_002dleap-Invocation"></a> -<br> +<div class="header"> +<p> +Up: <a href="#Top" accesskey="u" rel="up">Top</a> </p> </div> +<a name="Invoking-update_002dleap"></a> +<h3 class="section">1 Invoking update-leap</h3> +<a name="index-update_002dleap"></a> +<a name="index-leap_002dseconds-file-manager_002fupdater"></a> -<h3 class="section">0.1 Invoking update-leap</h3> -<p><a name="index-update_002dleap-1"></a><a name="index-leap_002dseconds-file-manager_002fupdater-2"></a> - <p><code>update-leap</code> +<p><code>update-leap</code> will validate the file currently on the local system and if necessary, updates leap-second definition file. - - <p>Ordinarily, the file is found using the "leapfile" directive in -<code>ntp.conf(5)</code>. +</p> +<p>Ordinarily, the file is found using the "leapfile" directive in +<code>ntp.conf(5)</code>. However, an alternate location can be specified on the command line. - - <p>If the file does not exist, is not valid, has expired, or is expiring soon, +</p> +<p>If the file does not exist, is not valid, has expired, or is expiring soon, a new copy will be downloaded. If the new copy validates, it is installed and NTP is (optionally) restarted. - - <p>If the current file is acceptable, no download or restart occurs. - - <p>-c can also be used to invoke another script to perform administrative -functions, e.g. to copy the file to other local systems. +</p> +<p>If the current file is acceptable, no download or restart occurs. +</p> +<p>-c can also be used to invoke another script to perform administrative +functions, e.g. to copy the file to other local systems. .PP This can be run as a cron job. As the file is rarely updated, and leap seconds are announced at least one month in advance (usually longer), it -need not be run more frequently than about once every three weeks. +need not be run more frequently than about once every three weeks. .PP -For cron-friendly behavior, define CRONJOB=1 in the crontab. +For cron-friendly behavior, define CRONJOB=1 in the crontab. .PP This script depends on$REQUIREDCMDS - - <p>This section was generated by <strong>AutoGen</strong>, +</p> +<p>This section was generated by <strong>AutoGen</strong>, using the <code>agtexi-cmd</code> template and the option descriptions for the <code>update-leap</code> program. - -<ul class="menu"> -<li><a accesskey="1" href="#update_002dleap-usage">update-leap usage</a>: update-leap help/usage (<span class="option">--help</span>) -<li><a accesskey="2" href="#update_002dleap-source_002durl">update-leap source-url</a>: source-url option (-s) -<li><a accesskey="3" href="#update_002dleap-ipv4">update-leap ipv4</a>: ipv4 option (-4) -<li><a accesskey="4" href="#update_002dleap-destination">update-leap destination</a>: destination option (-d) -<li><a accesskey="5" href="#update_002dleap-expiration">update-leap expiration</a>: expiration option (-e) -<li><a accesskey="6" href="#update_002dleap-ntp_002dconf_002dfile">update-leap ntp-conf-file</a>: ntp-conf-file option (-f) -<li><a accesskey="7" href="#update_002dleap-force_002dupdate">update-leap force-update</a>: force-update option (-F) -<li><a accesskey="8" href="#update_002dleap-exit-status">update-leap exit status</a>: exit status -<li><a accesskey="9" href="#update_002dleap-Usage">update-leap Usage</a>: Usage -<li><a href="#update_002dleap-Authors">update-leap Authors</a>: Authors -</ul> - -<div class="node"> -<p><hr> -<a name="update_002dleap-usage"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-source_002durl">update-leap source-url</a>, -Up: <a rel="up" accesskey="u" href="#update_002dleap-Invocation">update-leap Invocation</a> -<br> +</p> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#update_002dleap-usage" accesskey="1">update-leap usage</a>:</td><td> </td><td align="left" valign="top">update-leap help/usage (<samp>--help</samp>) +</td></tr> +<tr><td align="left" valign="top">• <a href="#update_002dleap-source_002durl" accesskey="2">update-leap source-url</a>:</td><td> </td><td align="left" valign="top">source-url option (-s) +</td></tr> +<tr><td align="left" valign="top">• <a href="#update_002dleap-ipv4" accesskey="3">update-leap ipv4</a>:</td><td> </td><td align="left" valign="top">ipv4 option (-4) +</td></tr> +<tr><td align="left" valign="top">• <a href="#update_002dleap-destination" accesskey="4">update-leap destination</a>:</td><td> </td><td align="left" valign="top">destination option (-d) +</td></tr> +<tr><td align="left" valign="top">• <a href="#update_002dleap-expiration" accesskey="5">update-leap expiration</a>:</td><td> </td><td align="left" valign="top">expiration option (-e) +</td></tr> +<tr><td align="left" valign="top">• <a href="#update_002dleap-ntp_002dconf_002dfile" accesskey="6">update-leap ntp-conf-file</a>:</td><td> </td><td align="left" valign="top">ntp-conf-file option (-f) +</td></tr> +<tr><td align="left" valign="top">• <a href="#update_002dleap-force_002dupdate" accesskey="7">update-leap force-update</a>:</td><td> </td><td align="left" valign="top">force-update option (-F) +</td></tr> +<tr><td align="left" valign="top">• <a href="#update_002dleap-exit-status" accesskey="8">update-leap exit status</a>:</td><td> </td><td align="left" valign="top">exit status +</td></tr> +<tr><td align="left" valign="top">• <a href="#update_002dleap-Usage" accesskey="9">update-leap Usage</a>:</td><td> </td><td align="left" valign="top">Usage +</td></tr> +<tr><td align="left" valign="top">• <a href="#update_002dleap-Authors">update-leap Authors</a>:</td><td> </td><td align="left" valign="top">Authors +</td></tr> +</table> + +<hr> +<a name="update_002dleap-usage"></a> +<div class="header"> +<p> +Next: <a href="#update_002dleap-source_002durl" accesskey="n" rel="next">update-leap source-url</a>, Up: <a href="#update_002dleap-Invocation" accesskey="u" rel="up">update-leap Invocation</a> </p> </div> - -<h4 class="subsection">0.1.1 update-leap help/usage (<span class="option">--help</span>)</h4> - -<p><a name="index-update_002dleap-help-3"></a> -This is the automatically generated usage text for update-leap. - - <p>The text printed is the same whether selected with the <code>help</code> option -(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print -the usage text by passing it through a pager program. +<a name="update_002dleap-help_002fusage-_0028_002d_002dhelp_0029"></a> +<h4 class="subsection">1.1 update-leap help/usage (<samp>--help</samp>)</h4> +<a name="index-update_002dleap-help"></a> + +<p>This is the automatically generated usage text for update-leap. +</p> +<p>The text printed is the same whether selected with the <code>help</code> option +(<samp>--help</samp>) or the <code>more-help</code> option (<samp>--more-help</samp>). <code>more-help</code> will print +the usage text by passing it through a pager program. <code>more-help</code> is disabled on platforms without a working <code>fork(2)</code> function. The <code>PAGER</code> environment variable is -used to select the program, defaulting to <span class="file">more</span>. Both will exit +used to select the program, defaulting to <samp>more</samp>. Both will exit with a status code of 0. - +</p> +<div class="example"> <pre class="example"> + Usage: update-leap [options] Verifies and if necessary, updates leap-second definition file @@ -189,160 +238,159 @@ IO::Socket::SSL - version >= 1.56 NET::SSLeay - version >= 1.49 Version: 1.004 -</pre> - <div class="node"> -<p><hr> -<a name="update_002dleap-source_002durl"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-ipv4">update-leap ipv4</a>, -Previous: <a rel="previous" accesskey="p" href="#update_002dleap-usage">update-leap usage</a>, -Up: <a rel="up" accesskey="u" href="#update_002dleap-Invocation">update-leap Invocation</a> -<br> -</div> +</pre></div> -<h4 class="subsection">0.1.2 source-url option (-s)</h4> +<hr> +<a name="update_002dleap-source_002durl"></a> +<div class="header"> +<p> +Next: <a href="#update_002dleap-ipv4" accesskey="n" rel="next">update-leap ipv4</a>, Previous: <a href="#update_002dleap-usage" accesskey="p" rel="prev">update-leap usage</a>, Up: <a href="#update_002dleap-Invocation" accesskey="u" rel="up">update-leap Invocation</a> </p> +</div> +<a name="source_002durl-option-_0028_002ds_0029"></a> +<h4 class="subsection">1.2 source-url option (-s)</h4> +<a name="index-update_002dleap_002dsource_002durl"></a> -<p><a name="index-update_002dleap_002dsource_002durl-4"></a> -This is the “the url of the master copy of the leapseconds file” option. -This option takes a string argument. +<p>This is the “the url of the master copy of the leapseconds file” option. +This option takes a string argument. Specify the URL of the master copy to download $LEAPSRC -<div class="node"> -<p><hr> -<a name="update_002dleap-ipv4"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-destination">update-leap destination</a>, -Previous: <a rel="previous" accesskey="p" href="#update_002dleap-source_002durl">update-leap source-url</a>, -Up: <a rel="up" accesskey="u" href="#update_002dleap-Invocation">update-leap Invocation</a> -<br> +</p><hr> +<a name="update_002dleap-ipv4"></a> +<div class="header"> +<p> +Next: <a href="#update_002dleap-destination" accesskey="n" rel="next">update-leap destination</a>, Previous: <a href="#update_002dleap-source_002durl" accesskey="p" rel="prev">update-leap source-url</a>, Up: <a href="#update_002dleap-Invocation" accesskey="u" rel="up">update-leap Invocation</a> </p> </div> - -<h4 class="subsection">0.1.3 ipv4 option (-4)</h4> - -<p><a name="index-update_002dleap_002dipv4-5"></a> -This is the “use only ipv4 addresses for dns name resolution” option. - -<p class="noindent">This option has some usage constraints. It: - <ul> -<li>must not appear in combination with any of the following options: -ipv6. -</ul> - - <p>Force DNS resolution of following host names on the command line - to the IPv4 namespace. +<a name="ipv4-option-_0028_002d4_0029"></a> +<h4 class="subsection">1.3 ipv4 option (-4)</h4> +<a name="index-update_002dleap_002dipv4"></a> + +<p>This is the “use only ipv4 addresses for dns name resolution” option. +</p> +<p>This option has some usage constraints. It: +</p><ul> +<li> must not appear in combination with any of the following options: +ipv6. +</li></ul> + +<p>Force DNS resolution of following host names on the command line + to the IPv4 namespace. _EndOfDoc_; ; - - <p>flag = +</p> +<p>flag = name = ipv6; flags-cant = ipv4, prefer; value = 6; - descrip = "Use only IPv6 addresses for DNS name resolution"; + descrip = "Use only IPv6 addresses for DNS name resolution"; doc = <<- _EndOfDoc_ Force DNS resolution of following host names on the command line - to the IPv6 namespace. + to the IPv6 namespace. _EndOfDoc_; ; - - <p>flag = +</p> +<p>flag = name = prefer; flags-cant = ipv4, ipv6; value = p; arg-type = keyword; keyword = 4, 6; - descrip = 'Prefer IPv4 or IPv6 (as specified) addresses, but use either'; + descrip = ’Prefer IPv4 or IPv6 (as specified) addresses, but use either’; doc = <<- _EndOfDoc_ -Prefer IPv4 or IPv6 (as specified) addresses, but use either. -<div class="node"> -<p><hr> -<a name="update_002dleap-destination"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-expiration">update-leap expiration</a>, -Previous: <a rel="previous" accesskey="p" href="#update_002dleap-ipv4">update-leap ipv4</a>, -Up: <a rel="up" accesskey="u" href="#update_002dleap-Invocation">update-leap Invocation</a> -<br> +Prefer IPv4 or IPv6 (as specified) addresses, but use either. +</p><hr> +<a name="update_002dleap-destination"></a> +<div class="header"> +<p> +Next: <a href="#update_002dleap-expiration" accesskey="n" rel="next">update-leap expiration</a>, Previous: <a href="#update_002dleap-ipv4" accesskey="p" rel="prev">update-leap ipv4</a>, Up: <a href="#update_002dleap-Invocation" accesskey="u" rel="up">update-leap Invocation</a> </p> </div> +<a name="destination-option-_0028_002dd_0029"></a> +<h4 class="subsection">1.4 destination option (-d)</h4> +<a name="index-update_002dleap_002ddestination"></a> -<h4 class="subsection">0.1.4 destination option (-d)</h4> - -<p><a name="index-update_002dleap_002ddestination-6"></a> -This is the “filename on the local system” option. -This option takes a string argument <span class="file">float</span>. -The name to use to store the leapfile on the local system. +<p>This is the “filename on the local system” option. +This option takes a string argument <samp>float</samp>. +The name to use to store the leapfile on the local system. $LEAPFILE -<div class="node"> -<p><hr> -<a name="update_002dleap-expiration"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-ntp_002dconf_002dfile">update-leap ntp-conf-file</a>, -Previous: <a rel="previous" accesskey="p" href="#update_002dleap-destination">update-leap destination</a>, -Up: <a rel="up" accesskey="u" href="#update_002dleap-Invocation">update-leap Invocation</a> -<br> +</p><hr> +<a name="update_002dleap-expiration"></a> +<div class="header"> +<p> +Next: <a href="#update_002dleap-ntp_002dconf_002dfile" accesskey="n" rel="next">update-leap ntp-conf-file</a>, Previous: <a href="#update_002dleap-destination" accesskey="p" rel="prev">update-leap destination</a>, Up: <a href="#update_002dleap-Invocation" accesskey="u" rel="up">update-leap Invocation</a> </p> </div> +<a name="expiration-option-_0028_002de_0029"></a> +<h4 class="subsection">1.5 expiration option (-e)</h4> +<a name="index-update_002dleap_002dexpiration"></a> -<h4 class="subsection">0.1.5 expiration option (-e)</h4> - -<p><a name="index-update_002dleap_002dexpiration-7"></a> -This is the “refresh the leapfile this long before it expires” option. -This option takes a string argument. +<p>This is the “refresh the leapfile this long before it expires” option. +This option takes a string argument. Specify how long before expiration the file is to be refreshed -Units are required, e.g. "-e 60 days" Note that larger values -imply more frequent refreshes. -"$PREFETCH" -<div class="node"> -<p><hr> -<a name="update_002dleap-ntp_002dconf_002dfile"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-force_002dupdate">update-leap force-update</a>, -Previous: <a rel="previous" accesskey="p" href="#update_002dleap-expiration">update-leap expiration</a>, -Up: <a rel="up" accesskey="u" href="#update_002dleap-Invocation">update-leap Invocation</a> -<br> +Units are required, e.g. "-e 60 days" Note that larger values +imply more frequent refreshes. +"$PREFETCH" +</p><hr> +<a name="update_002dleap-ntp_002dconf_002dfile"></a> +<div class="header"> +<p> +Next: <a href="#update_002dleap-force_002dupdate" accesskey="n" rel="next">update-leap force-update</a>, Previous: <a href="#update_002dleap-expiration" accesskey="p" rel="prev">update-leap expiration</a>, Up: <a href="#update_002dleap-Invocation" accesskey="u" rel="up">update-leap Invocation</a> </p> </div> +<a name="ntp_002dconf_002dfile-option-_0028_002df_0029"></a> +<h4 class="subsection">1.6 ntp-conf-file option (-f)</h4> +<a name="index-update_002dleap_002dntp_002dconf_002dfile"></a> -<h4 class="subsection">0.1.6 ntp-conf-file option (-f)</h4> - -<p><a name="index-update_002dleap_002dntp_002dconf_002dfile-8"></a> -This is the “location of the ntp.conf file” option. -This option takes a string argument. +<p>This is the “location of the ntp.conf file” option. +This option takes a string argument. Specify location of ntp.conf (used to make sure leapfile directive is present and to default leapfile) /etc/ntp.conf -<div class="node"> -<p><hr> -<a name="update_002dleap-force_002dupdate"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-exit-status">update-leap exit status</a>, -Previous: <a rel="previous" accesskey="p" href="#update_002dleap-ntp_002dconf_002dfile">update-leap ntp-conf-file</a>, -Up: <a rel="up" accesskey="u" href="#update_002dleap-Invocation">update-leap Invocation</a> -<br> +</p><hr> +<a name="update_002dleap-force_002dupdate"></a> +<div class="header"> +<p> +Next: <a href="#update_002dleap-exit-status" accesskey="n" rel="next">update-leap exit status</a>, Previous: <a href="#update_002dleap-ntp_002dconf_002dfile" accesskey="p" rel="prev">update-leap ntp-conf-file</a>, Up: <a href="#update_002dleap-Invocation" accesskey="u" rel="up">update-leap Invocation</a> </p> </div> - -<h4 class="subsection">0.1.7 force-update option (-F)</h4> - -<p><a name="index-update_002dleap_002dforce_002dupdate-9"></a> -This is the “force update of the leapfile” option. -Force update even if current file is OK and not close to expiring. -<div class="node"> -<p><hr> -<a name="update_002dleap-exit-status"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-Usage">update-leap Usage</a>, -Previous: <a rel="previous" accesskey="p" href="#update_002dleap-force_002dupdate">update-leap force-update</a>, -Up: <a rel="up" accesskey="u" href="#update_002dleap-Invocation">update-leap Invocation</a> -<br> +<a name="force_002dupdate-option-_0028_002dF_0029"></a> +<h4 class="subsection">1.7 force-update option (-F)</h4> +<a name="index-update_002dleap_002dforce_002dupdate"></a> + +<p>This is the “force update of the leapfile” option. +Force update even if current file is OK and not close to expiring. +</p><hr> +<a name="update_002dleap-exit-status"></a> +<div class="header"> +<p> +Next: <a href="#update_002dleap-Usage" accesskey="n" rel="next">update-leap Usage</a>, Previous: <a href="#update_002dleap-force_002dupdate" accesskey="p" rel="prev">update-leap force-update</a>, Up: <a href="#update_002dleap-Invocation" accesskey="u" rel="up">update-leap Invocation</a> </p> </div> - -<h4 class="subsection">0.1.8 update-leap exit status</h4> +<a name="update_002dleap-exit-status-1"></a> +<h4 class="subsection">1.8 update-leap exit status</h4> <p>One of the following exit values will be returned: - <dl> -<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution. -<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid. +</p><dl compact="compact"> +<dt>‘<samp>0 (EXIT_SUCCESS)</samp>’</dt> +<dd><p>Successful program execution. +</p></dd> +<dt>‘<samp>1 (EXIT_FAILURE)</samp>’</dt> +<dd><p>The operation failed or the command syntax was not valid. +</p></dd> </dl> - <div class="node"> -<p><hr> -<a name="update_002dleap-Usage"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-Authors">update-leap Authors</a>, -Previous: <a rel="previous" accesskey="p" href="#update_002dleap-exit-status">update-leap exit status</a>, -Up: <a rel="up" accesskey="u" href="#update_002dleap-Invocation">update-leap Invocation</a> -<br> +<hr> +<a name="update_002dleap-Usage"></a> +<div class="header"> +<p> +Next: <a href="#update_002dleap-Authors" accesskey="n" rel="next">update-leap Authors</a>, Previous: <a href="#update_002dleap-exit-status" accesskey="p" rel="prev">update-leap exit status</a>, Up: <a href="#update_002dleap-Invocation" accesskey="u" rel="up">update-leap Invocation</a> </p> </div> - -<h4 class="subsection">0.1.9 update-leap Usage</h4> - -<div class="node"> -<p><hr> -<a name="update_002dleap-Authors"></a>Previous: <a rel="previous" accesskey="p" href="#update_002dleap-Usage">update-leap Usage</a>, -Up: <a rel="up" accesskey="u" href="#update_002dleap-Invocation">update-leap Invocation</a> -<br> +<a name="update_002dleap-Usage-1"></a> +<h4 class="subsection">1.9 update-leap Usage</h4> +<hr> +<a name="update_002dleap-Authors"></a> +<div class="header"> +<p> +Previous: <a href="#update_002dleap-Usage" accesskey="p" rel="prev">update-leap Usage</a>, Up: <a href="#update_002dleap-Invocation" accesskey="u" rel="up">update-leap Invocation</a> </p> </div> +<a name="update_002dleap-Authors-1"></a> +<h4 class="subsection">1.10 update-leap Authors</h4> +<hr> -<h4 class="subsection">0.1.10 update-leap Authors</h4> -</body></html> +</body> +</html> diff --git a/contrib/ntp/scripts/update-leap/update-leap.man.in b/contrib/ntp/scripts/update-leap/update-leap.man.in index ac138146ed81..33aa4f66538f 100644 --- a/contrib/ntp/scripts/update-leap/update-leap.man.in +++ b/contrib/ntp/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 "14 Aug 2018" "ntp (4.2.8p12)" "User Commands" +.TH update-leap 1update-leapman "20 Feb 2019" "ntp (4.2.8p13)" "User Commands" .\" -.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-4Iayif/ag-fJaGhf) +.\" EDIT THIS FILE WITH CAUTION (in-mem file) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:29 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 05:04:24 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/contrib/ntp/scripts/update-leap/update-leap.mdoc.in b/contrib/ntp/scripts/update-leap/update-leap.mdoc.in index e3845dcc3849..fe1a164720c0 100644 --- a/contrib/ntp/scripts/update-leap/update-leap.mdoc.in +++ b/contrib/ntp/scripts/update-leap/update-leap.mdoc.in @@ -1,9 +1,9 @@ -.Dd August 14 2018 +.Dd February 20 2019 .Dt UPDATE_LEAP 1update-leapmdoc User Commands .Os .\" EDIT THIS FILE WITH CAUTION (update-leap-opts.mdoc) .\" -.\" It has been AutoGen-ed August 14, 2018 at 08:09:36 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 20, 2019 at 09:57:38 AM by AutoGen 5.18.5 .\" From the definitions update-leap-opts.def .\" and the template file agmdoc-cmd.tpl .Sh NAME |