[ntpsec commit] More name parameterization via asciidoc attributes in the documentation.
Eric S. Raymond
esr at ntpsec.org
Tue Oct 6 15:57:06 UTC 2015
Module: ntpsec
Branch: master
Commit: a9f66c42301d52176992c4a951065a8a200181a7
Changeset: http://git.ntpsec.org/ntpsec/commit/?id=a9f66c42301d52176992c4a951065a8a200181a7
Author: Eric S. Raymond <esr at thyrsus.com>
Date: Tue Oct 6 11:54:30 2015 -0400
More name parameterization via asciidoc attributes in the documentation.
Also, remove all Last-update headers. Rendering the documents through asciidoc
generates better ones.
---
docs/access.txt | 1 -
docs/accopt.txt | 1 -
docs/asciidoc.conf | 7 ++++---
docs/assoc.txt | 23 +++++++++++------------
docs/audio.txt | 1 -
docs/authentic.txt | 3 +--
docs/authopt.txt | 1 -
docs/autokey.txt | 4 ----
docs/bugs.txt | 1 -
docs/build.txt | 1 -
docs/clock.txt | 2 --
docs/clockopt.txt | 1 -
docs/cluster.txt | 4 ----
docs/comdex.txt | 1 -
docs/confopt.txt | 1 -
docs/copyright.txt | 1 -
docs/debug.txt | 1 -
docs/decode.txt | 1 -
docs/discipline.txt | 2 --
docs/discover.txt | 1 -
docs/driver28.txt | 16 ++++++++--------
docs/driver46.txt | 6 +++---
docs/driver8.txt | 1 -
docs/extern.txt | 4 ----
docs/filter.txt | 4 ----
docs/hints.txt | 2 --
docs/howto.txt | 1 -
docs/huffpuff.txt | 4 ----
docs/kern.txt | 25 +++++++++++--------------
docs/kernpps.txt | 1 -
docs/keygen-body.txt | 4 ++--
docs/keygen.txt | 1 -
docs/leap.txt | 4 ----
docs/miscopt.txt | 1 -
docs/monopt.txt | 1 -
docs/msyslog.txt | 4 +---
docs/mx4200data.txt | 4 ----
docs/ntp_conf.txt | 1 -
docs/ntpd-body.txt | 2 +-
docs/ntpd.txt | 1 -
docs/ntpdsim.txt | 2 +-
docs/ntpdsim_new.txt | 1 -
docs/ntpq-body.txt | 4 ++--
docs/ntpq.txt | 1 -
docs/ntptime.txt | 1 -
docs/ntptrace.txt | 1 -
docs/oncore-shmem.txt | 6 +-----
docs/orphan.txt | 4 ----
docs/parsedata.txt | 2 --
docs/parsenew.txt | 2 --
docs/poll.txt | 4 ----
docs/pps.txt | 3 +--
docs/prefer.txt | 1 -
docs/quick.txt | 4 ----
docs/rate.txt | 1 -
docs/rdebug.txt | 1 -
docs/select.txt | 6 +-----
docs/sntp-body.txt | 2 +-
docs/stats.txt | 2 --
docs/tf582_4.txt | 4 ----
docs/tickadj.txt | 4 ----
docs/warp.txt | 2 --
docs/xleave.txt | 1 -
ntp-keygen/ntp-keygen.c | 1 +
ntpd/ntp.conf.txt | 3 ++-
ntpd/ntp.keys.txt | 25 +++++--------------------
66 files changed, 57 insertions(+), 176 deletions(-)
diff --git a/docs/access.txt b/docs/access.txt
index 7bbdb80..0db7a7a 100644
--- a/docs/access.txt
+++ b/docs/access.txt
@@ -7,7 +7,6 @@
The skunk watches for intruders and sprays.
-Last update: 11-Sep-2010 05:53 UTC
|==============================
== Related Links ==
diff --git a/docs/accopt.txt b/docs/accopt.txt
index 51148c5..7526b92 100644
--- a/docs/accopt.txt
+++ b/docs/accopt.txt
@@ -7,7 +7,6 @@
The skunk watches for intruders and sprays.
-Last update: 13-Nov-2014 03:00 UTC
|==============================
== Related Links ==
diff --git a/docs/asciidoc.conf b/docs/asciidoc.conf
index 70df7a7..33a9fed 100644
--- a/docs/asciidoc.conf
+++ b/docs/asciidoc.conf
@@ -17,12 +17,13 @@ project-bugtracker="NTPsec"
millshome=http://www.eecis.udel.edu/~mills/
ntpd=ntpd
ntpdconf=ntpd.conf
+ntpkeys=ntp.keys
ntpq=ntpq
-sntp=sntp
ntptime=ntp-time
ntpwait=ntp-wait
-ntpconfman=ntpconf(5)
-ntokeysman=ntp.keys(5)
+sntp=sntp
+ntpconfman=ntp.conf(5)
+ntpkeysman=ntp.keys(5)
ntpdman=ntpd(8)
ntpkeygenman=ntp-keygen(8)
ntpqman=ntpq(1)
diff --git a/docs/assoc.txt b/docs/assoc.txt
index eda64fe..c6ca687 100644
--- a/docs/assoc.txt
+++ b/docs/assoc.txt
@@ -7,7 +7,6 @@
Make sure who your friends are.
-Last update: 31-Jan-2014 06:54 UTC
|==============================
@@ -33,8 +32,8 @@ include::includes/hand.txt[]
This page describes the various modes of operation provided in NTPv4.
There are three types of associations in NTP: _persistent_,
_preemptable_ and _ephemeral_. Persistent associations are mobilized by
-a configuration command and never demobilized. Preemptable associations,
-which are new to NTPv4, are mobilized by a configuration command which
+a configuration command and never demobilized. Preemptable associations
+are mobilized by a configuration command which
includes the `preempt` option or upon arrival of an automatic server
discovery packet. They are are demobilized by timeout or when preempted
by a "better" server, as described on the link:discover.html[Automatic
@@ -160,9 +159,9 @@ NTP uses an intricate heuristic algorithm to automatically control the
poll interval for maximum accuracy consistent with minimum network
overhead. The algorithm measures the incidental offset and jitter to
determine the best poll interval. When `{ntpd}` starts, the interval is
-the default minimum 64 s. Under normal conditions when the clock
+the default minimum 64 sec. Under normal conditions when the clock
discipline has stabilized, the interval increases in steps to the
-default maximum 1024 s. In addition, should a server become unreachable
+default maximum 1024 sec. In addition, should a server become unreachable
after some time, the interval increases in steps to the maximum in order
to reduce network overhead. Additional information about the algorithm
is on the link:poll.html[Poll Program] page.
@@ -172,7 +171,7 @@ be changed using options on the link:confopt.html[Server Commands and
Options] and link:miscopt.html[Miscellaneous Options] pages. However,
when using maximum intervals much larger than the default, the residual
clock frequency error must be small enough for the discipline loop to
-capture and correct. The capture range is 500 PPM with a 64-s interval
+capture and correct. The capture range is 500 PPM with a 64-sec interval
decreasing by a factor of two for each interval doubling. At a 36-hr
interval, for example, the capture range is only 0.24 PPM.
@@ -180,7 +179,7 @@ In the NTPv4 specification and reference implementation, the poll
interval is expressed in log~2~ units, properly called the _poll
exponent._ It is constrained by the lower limit `minpoll` and upper
limit `maxpoll` options of the link:confopt.html[`server`] command. The
-limits default to 6 (64 s) and 10 (1024 s), respectively, which are
+limits default to 6 (64 sec) and 10 (1024 sec), respectively, which are
appropriate for the vast majority of cases.
As a rule of thumb, the expected errors increase by a factor of two as
@@ -195,12 +194,12 @@ interval is managed automatically as a function of prevailing jitter and
wander. The most common exceptions are the following.
* With fast, lightly loaded LANs and modern processors, the nominal
-Allan intercept is about 500 s. In these cases the expected errors can
-be further reduced using a poll exponent of 4 (16 s). In the case of the
+Allan intercept is about 500 sec. In these cases the expected errors can
+be further reduced using a poll exponent of 4 (16 sec). In the case of the
pulse-per-second (PPS) driver, this is the recommended value.
* With symmetric modes the most stable behavior results when both peers
are configured in symmetric active mode with matching poll intervals of
-6 (64 s).
+6 (64 sec).
* The poll interval should not be modified for reference clocks, with
the single exception the ACTS telephone modem driver. In this case the
recommended minimum and maximum intervals are 12 (1.1 hr) and 17 (36
@@ -212,7 +211,7 @@ hr), respectively.
Occasionally it is necessary to send packets temporarily at intervals
less than the poll interval. For instance, with the `burst` and `iburst`
options of the link:confopt.html[`server`] command, the poll program
-sends a burst of several packets at 2-s intervals. In either case the
+sends a burst of several packets at 2-sec intervals. In either case the
poll program avoids sending needless packets if the server is not
responding. The client begins a burst with a single packet. When the
first packet is received from the server, the client continues with the
@@ -242,7 +241,7 @@ further details about the startup behavior.
The `burst` option is useful in cases of severe network jitter or when
the network attachment requires an initial calling or training sequence.
This option is recommended when the minimum poll exponent is larger than
-10 (1024 s). A burst is sent only when the server is reachable. The
+10 (1024 sec). A burst is sent only when the server is reachable. The
number of packets in the burst is determined by the poll interval so
that the average interval between packets (headway) is no less than the
minimum poll interval for the association.
diff --git a/docs/audio.txt b/docs/audio.txt
index 7f438ee..7e6bbee 100644
--- a/docs/audio.txt
+++ b/docs/audio.txt
@@ -5,7 +5,6 @@
|image:pic/radio2.jpg[ICOM R-72 shortwave receiver and Sure audio mixer]|
ICOM R-72 shortwave receiver and Sure audio mixer
-Last update: 20-Sep-2015 02:00 UTC
|==============================
== Related Links ==
diff --git a/docs/authentic.txt b/docs/authentic.txt
index 07a6e9b..aae64d6 100644
--- a/docs/authentic.txt
+++ b/docs/authentic.txt
@@ -7,7 +7,6 @@ http://www.eecis.udel.edu/%7emills/pictures.html[from 'Alice's Adventures in Won
Our resident cryptographer; now you see him, now you don't.
-Last update: 1-Dec-2012 04:44 UTC
|==============================
== Related Links ==
@@ -146,7 +145,7 @@ Keys and related information are specified in a keys file, which must be
distributed and stored using secure means beyond the scope of the NTP
protocol itself. Besides the keys used for ordinary NTP associations,
additional keys can be used as passwords for the `{ntpq}`
-utility program. Ordinarily, the `ntp.keys` file is generated by the
+utility program. Ordinarily, the `{ntpkeys}` file is generated by the
`ntp-keygen` program, but it can be constructed and edited using an
ordinary text editor.
diff --git a/docs/authopt.txt b/docs/authopt.txt
index 1a8003c..27374c0 100644
--- a/docs/authopt.txt
+++ b/docs/authopt.txt
@@ -8,7 +8,6 @@ http://www.eecis.udel.edu/%7emills/pictures.html[from
Our resident cryptographer; now you see him, now you don't.
-Last update: 15-Oct-2011 01:00 UTC
|==============================
== Related Links ==
diff --git a/docs/autokey.txt b/docs/autokey.txt
index a595794..41e45ce 100644
--- a/docs/autokey.txt
+++ b/docs/autokey.txt
@@ -1,9 +1,5 @@
= Autokey Public-Key Authentication =
-Last update: 20-Sep-2015 01:45 UTC
-
-'''''
-
== Table of Contents ==
* link:#noauto[Problems with Autokey]
diff --git a/docs/bugs.txt b/docs/bugs.txt
index 0d7b783..5ac0caa 100644
--- a/docs/bugs.txt
+++ b/docs/bugs.txt
@@ -7,7 +7,6 @@ http://www.eecis.udel.edu/%7emills/pictures.html[from 'Alice's Adventures in Won
The rabbit toots to make sure you read this.
-Last update: 23-Aug-2014 05:32 UTC
|==============================
'''''
diff --git a/docs/build.txt b/docs/build.txt
index 98e9133..fc2dbd5 100644
--- a/docs/build.txt
+++ b/docs/build.txt
@@ -7,7 +7,6 @@ http://www.eecis.udel.edu/%7emills/pictures.html[from 'Pogo', Walt Kelly]
For putting out compiler fires.
-Last update: 20-Sep-2015 02:05 UTC
|==============================
== Related Links ==
diff --git a/docs/clock.txt b/docs/clock.txt
index 77ba5d6..bb54be7 100644
--- a/docs/clock.txt
+++ b/docs/clock.txt
@@ -1,7 +1,5 @@
= Clock State Machine =
-Last update: 4-Aug-2011 23:40 UTC
-
== Table of Contents ==
* link:#intro[General Overview]
diff --git a/docs/clockopt.txt b/docs/clockopt.txt
index 54bdfb1..fc5370b 100644
--- a/docs/clockopt.txt
+++ b/docs/clockopt.txt
@@ -5,7 +5,6 @@
|image:pic/stack1a.jpg[]|
Master Time Facility at the http://www.eecis.udel.edu/%7emills/lab.html[UDel Internet Research Laboratory]
-Last update: 11-Sep-2010 05:55 UTC
|==============================
== Related Links ==
diff --git a/docs/cluster.txt b/docs/cluster.txt
index bc0beff..1ac93da 100644
--- a/docs/cluster.txt
+++ b/docs/cluster.txt
@@ -1,9 +1,5 @@
= Clock Cluster Algorithm =
-Last update: 15-Nov-2012 06:02 UTC
-
-'''''
-
The clock cluster algorithm processes the truechimers produced by the
clock select algorithm to produce a list of _survivors_. These survivors
are used by the mitigation algorithms to discipline the system clock.
diff --git a/docs/comdex.txt b/docs/comdex.txt
index 8fc9e1b..cf39f8f 100644
--- a/docs/comdex.txt
+++ b/docs/comdex.txt
@@ -7,7 +7,6 @@ http://www.eecis.udel.edu/%7emills/pictures.html[from['Alice's Adventures in Won
The Mad Hatter says "Bring it on".
-Last update: 31-Jan-2014 06:54 UTC
|==============================
== Related Links ==
diff --git a/docs/confopt.txt b/docs/confopt.txt
index 4e5d3ba..ee245b8 100644
--- a/docs/confopt.txt
+++ b/docs/confopt.txt
@@ -7,7 +7,6 @@
The chicken is getting configuration advice.
-Last update: 10-Mar-2014 05:01 UTC
|==============================
== Related Links ==
diff --git a/docs/copyright.txt b/docs/copyright.txt
index 9158f00..930d6c2 100644
--- a/docs/copyright.txt
+++ b/docs/copyright.txt
@@ -5,7 +5,6 @@
|image:pic/sheepb.jpg[]|
"Clone me," says Dolly sheepishly.
-Last update: 17-Jan-2015 00:16 UTC
|==============================
'''''
diff --git a/docs/debug.txt b/docs/debug.txt
index c2d5071..c324e61 100644
--- a/docs/debug.txt
+++ b/docs/debug.txt
@@ -7,7 +7,6 @@ http://www.eecis.udel.edu/%7emills/pictures.html[from 'Pogo', Walt Kelly]
We make house calls and bring our own bugs.
-Last update: 16-Jul-2014 08:38 UTC
|==============================
== More Help ==
diff --git a/docs/decode.txt b/docs/decode.txt
index 2994ad8..93bf731 100644
--- a/docs/decode.txt
+++ b/docs/decode.txt
@@ -7,7 +7,6 @@ http://www.eecis.udel.edu/%7emills/pictures.html[from 'Alice's Adventures in Won
Caterpillar knows all the error codes, which is more than most of us do.
-Last update: 16-Jul-2014 04:48 UTC
|==============================
diff --git a/docs/discipline.txt b/docs/discipline.txt
index 2202fef..0efa860 100644
--- a/docs/discipline.txt
+++ b/docs/discipline.txt
@@ -1,7 +1,5 @@
= Clock Discipline Algorithm =
-Last update: 10-Mar-2014 05:03 UTC
-
== Table of Contents ==
* link:#intro[General Overview]
diff --git a/docs/discover.txt b/docs/discover.txt
index 314a980..40d6416 100644
--- a/docs/discover.txt
+++ b/docs/discover.txt
@@ -7,7 +7,6 @@ http://www.eecis.udel.edu/%7emills/pictures.html[from 'Alice's Adventures in Won
Make sure who your friends are.
-Last update: 10-Mar-2014 05:04 UTC
|==============================
== Related Links ==
diff --git a/docs/driver28.txt b/docs/driver28.txt
index 45c3965..41b90fb 100644
--- a/docs/driver28.txt
+++ b/docs/driver28.txt
@@ -48,7 +48,7 @@ checked:
If set, the values in the record (clockTimeStampSec, clockTimeStampUSec,
receiveTimeStampSec, receiveTimeStampUSec, leap, precision) are passed
-to _NTPD_, and `valid` is cleared and `count` is bumped.
+to _{ntpd}_, and `valid` is cleared and `count` is bumped.
If not set, `count` is bumped.
@@ -60,10 +60,10 @@ If set, the `count` field of the record is remembered, and the values in
the record (clockTimeStampSec, clockTimeStampUSec, receiveTimeStampSec,
receiveTimeStampUSec, leap, precision) are read. Then, the remembered
`count` is compared to current value of `count` now in the record. If
-both are equal, the values read from the record are passed to _NTPD_. If
+both are equal, the values read from the record are passed to _{ntpd}_. If
they differ, another process has modified the record while it was read
out (was not able to produce this case), and failure is reported to
-_NTPD_. The `valid` flag is cleared and `count` is bumped.
+_{ntpd}_. The `valid` flag is cleared and `count` is bumped.
If not set, `count` is bumped
@@ -82,7 +82,7 @@ discarded. This check is disabled when _flag1_ is set to 1.
== GPSD ==
http://gpsd.berlios.de/[_GPSD_] knows how to talk to many GPS devices.
-It can work with _NTPD_ through the SHM driver.
+It can work with _{ntpd}_ through the SHM driver.
The _GPSD_ man page suggests setting minpoll and maxpoll to 4. That was
an attempt to reduce jitter. The SHM driver was fixed (ntp-4.2.5p138) to
@@ -91,11 +91,11 @@ suggestion is no longer reasonable.
*Note:* The _GPSD_ client driver (type 46) uses the _GPSD_ client
protocol to connect and talk to _GPSD_, but using the SHM driver is the
-ancient way to have _GPSD_ talk to _NTPD_. There are some tricky points
+ancient way to have _GPSD_ talk to _{ntpd}_. There are some tricky points
when using the SHM interface to interface with _GPSD_, because _GPSD_
will use two SHM clocks, one for the serial data stream and one for the
PPS information when available. Receivers with a loose/sloppy timing
-between PPS and serial data can easily cause trouble here because _NTPD_
+between PPS and serial data can easily cause trouble here because _{ntpd}_
has no way to join the two data streams and correlate the serial data
with the PPS events.
@@ -107,9 +107,9 @@ common to all clockstats records.
The 4th field is the number of second ticks since the last poll. The 5th
field is the number of good data samples found. The last 64 will be used
-by _NTPD_. The 6th field is the number of sample that didn't have valid
+by _{ntpd}_. The 6th field is the number of sample that didn't have valid
data ready. The 7th field is the number of bad samples. The 8th field is
-the number of times the the mode 1 info was update while _NTPD_ was
+the number of times the the mode 1 info was update while _{ntpd}_ was
trying to grab a sample.
Here is a sample showing the GPS reception fading out:
diff --git a/docs/driver46.txt b/docs/driver46.txt
index d384b4e..03da6de 100644
--- a/docs/driver46.txt
+++ b/docs/driver46.txt
@@ -10,8 +10,8 @@ Serial Port: /dev/gps__u__
== Description ==
-This driver is a client driver to the _GPSD_ daemon, which over the time
-became increasingly popular for UN*Xish platforms. _GPSD_ can manage
+This driver is a client driver to the _GPSD_ daemon, which over time has
+become increasingly popular for UN*Xish platforms. _GPSD_ can manage
several devices in parallel, aggregate information, and acts as a data
hub for client applications. _GPSD_ can also auto-detect and handle PPS
hardware signals on serial ports. Have a look at
@@ -211,7 +211,7 @@ since the last poll.
using automatic mode (mode 2).
`flag3 0 | 1`::
_[Primary Unit]_ If set, [underline]#disables# the log throttle. Useful when
- tracking problems in the interaction between _GPSD_ and _NTPD_, since
+ tracking problems in the interaction between _GPSD_ and _{ntpd}_, since
now all error events are logged. Persistent/recurrent errors can
easily fill up the log, so this should only be enabled during bug
hunts.
diff --git a/docs/driver8.txt b/docs/driver8.txt
index 3e826ff..28f79e7 100644
--- a/docs/driver8.txt
+++ b/docs/driver8.txt
@@ -172,7 +172,6 @@ link:imap://mills@mail.eecis.udel.edu:993/fetch%3EUID%3E.INBOX%3E67132?part=1.3&
18] should be used if the device is accessed by a multidrop connection.
+
*Note:* mode 7 must not be used with Meinberg PCI cards; use mode 2 instead.
-//ERROR: The (see list below) ref that used to live here was to a dead IMAP URL.
* *server 127.127.8.0-3 mode 8*
+
diff --git a/docs/extern.txt b/docs/extern.txt
index accc7ab..afe3907 100644
--- a/docs/extern.txt
+++ b/docs/extern.txt
@@ -1,9 +1,5 @@
= External Clock Discipline and the Local Clock Driver =
-Last update: 9-May-2014 04:46 UTC
-
-'''''
-
The NTPv4 implementation includes provisions for an external clock,
where the system clock is implemented by some external hardware device.
One implementation might take the form of a bus peripheral with a high
diff --git a/docs/filter.txt b/docs/filter.txt
index c0739bd..d4e863d 100644
--- a/docs/filter.txt
+++ b/docs/filter.txt
@@ -1,9 +1,5 @@
= Clock Filter Algorithm =
-Last update: 10-Mar-2014 05:05 UTC
-
-'''''
-
The clock filter algorithm processes the offset and delay samples
produced by the on-wire protocol for each peer process separately. It
uses a sliding window of eight samples and picks out the sample with the
diff --git a/docs/hints.txt b/docs/hints.txt
index 2a4cf53..ce657a0 100644
--- a/docs/hints.txt
+++ b/docs/hints.txt
@@ -5,8 +5,6 @@ image:pic/alice35.gif[image]http://www.eecis.udel.edu/%7emills/pictures.html[fro
Mother in law has all the answers.
-Last update: 20-Sep-2015 05:11 UTC
-
'''''
diff --git a/docs/howto.txt b/docs/howto.txt
index 3e79692..0fffe08 100644
--- a/docs/howto.txt
+++ b/docs/howto.txt
@@ -7,7 +7,6 @@ http://www.eecis.udel.edu/%7emills/pictures.html[from 'Pogo', Walt Kelly]
You need a little magic.
-Last update: 10-Mar-2014 05:08 UTC
|==============================
== Related Links ==
diff --git a/docs/huffpuff.txt b/docs/huffpuff.txt
index 08609a1..faa5d72 100644
--- a/docs/huffpuff.txt
+++ b/docs/huffpuff.txt
@@ -1,9 +1,5 @@
= The Huff-n'-Puff Filter =
-Last update: 10-Mar-2014 05:09 UTC
-
-'''''
-
In scenarios where a considerable amount of data are downloaded or
uploaded using DSL or telephone modem lines, timekeeping quality can be
seriously degraded. This occurs because the traffic volume, and thus the
diff --git a/docs/kern.txt b/docs/kern.txt
index 5946f00..82fa577 100644
--- a/docs/kern.txt
+++ b/docs/kern.txt
@@ -5,9 +5,6 @@ image:pic/alice61.gif[]
Alice finds the kernel a house of cards.
-Last update: 10-Mar-2014 05:10 UTC
-
-
== Related Links ==
include::includes/misc.txt[]
@@ -49,27 +46,27 @@ signal from a GPS receiver and a modern computer are in the 3 μs range.
1. Mills, D.L., and P.-H. Kamp. The nanokernel. _Proc. Precision Time
and Time Interval (PTTI) Applications and Planning Meeting_ (Reston VA,
November 2000). Paper:
-http://www.eecis.udel.edu/%7emills/database/papers/nano/nano2.ps[PostScript]
+{millshome}database/papers/nano/nano2.ps[PostScript]
|
-http://www.eecis.udel.edu/%7emills/database/papers/nano/nano2.pdf[PDF],
+{millshome}database/papers/nano/nano2.pdf[PDF],
Slides:
-http://www.eecis.udel.edu/%7emills/database/brief/nano/nano.html[HTML] |
-http://www.eecis.udel.edu/%7emills/database/brief/nano/nano.ps[PostScript]
-| http://www.eecis.udel.edu/%7emills/database/brief/nano/nano.pdf[PDF] |
-http://www.eecis.udel.edu/%7emills/database/brief/nano/nano.ppt[PowerPoint]
+{millshome}database/brief/nano/nano.html[HTML] |
+{millshome}database/brief/nano/nano.ps[PostScript]
+| {millshome}database/brief/nano/nano.pdf[PDF] |
+{millshome}database/brief/nano/nano.ppt[PowerPoint]
2. Mills, D.L. Unix kernel modifications for precision time
synchronization. Electrical Engineering Department Report 94-10-1,
University of Delaware, October 1994, 24 pp. Abstract:
-http://www.eecis.udel.edu/%7emills/database/reports/kern/kerna.ps[PostScript]
+{millshome}database/reports/kern/kerna.ps[PostScript]
|
-http://www.eecis.udel.edu/%7emills/database/reports/kern/kerna.pdf[PDF],
+{millshome}database/reports/kern/kerna.pdf[PDF],
Body:
-http://www.eecis.udel.edu/%7emills/database/reports/kern/kernb.ps[PostScript]
+{millshome}database/reports/kern/kernb.ps[PostScript]
|
-http://www.eecis.udel.edu/%7emills/database/reports/kern/kernb.pdf[PDF]
+{millshome}database/reports/kern/kernb.pdf[PDF]
3. Mills, D.L. A kernel model for precision timekeeping. Network
Working Group Report RFC-1589, University of Delaware, March 1994. 31
-pp. http://www.eecis.udel.edu/%7emills/database/rfc/rfc1589.txt[ASCII]
+pp. {millshome}database/rfc/rfc1589.txt[ASCII]
'''''
diff --git a/docs/kernpps.txt b/docs/kernpps.txt
index 97daea1..df89edb 100644
--- a/docs/kernpps.txt
+++ b/docs/kernpps.txt
@@ -5,7 +5,6 @@
|image:pic/tonea.gif[]|
http://www.eecis.udel.edu/%7emills/pictures.html[from 'NBS Special Publication 432, 1979'] (out of print)
-Last update: 10-Mar-2014 05:10 UTC
|==============================
== Related Links ==
diff --git a/docs/keygen-body.txt b/docs/keygen-body.txt
index 8846dc2..c3d54d5 100644
--- a/docs/keygen-body.txt
+++ b/docs/keygen-body.txt
@@ -62,7 +62,7 @@ be read back by `{ntpd}` without password, but only on the same host.
Normally, encrypted files for each host are generated by that host and
used only by that host, although exceptions exist as noted later on this
-page. The symmetric keys file, normally called `ntp.keys`, is usually
+page. The symmetric keys file, normally called `{ntpkeys}`, is usually
installed in `/etc`. Other files and links are usually installed in
`/usr/local/etc`, which is normally in a shared filesystem in
NFS-mounted networks and cannot be changed by shared clients. The
@@ -524,7 +524,7 @@ format.
The `ntp-keygen` program generates a MD5 symmetric keys file
_ntpkey_MD5key_hostname.filestamp_. Since the file contains private
shared keys, it should be visible only to root and distributed by secure
-means to other subnet hosts. The NTP daemon loads the file _ntp.keys_,
+means to other subnet hosts. The NTP daemon loads the file _{ntpkeys}_,
so `ntp-keygen` installs a soft link from this name to the generated
file. Subsequently, similar soft links must be installed by manual or
automated means on the other subnet hosts. While this file is not used
diff --git a/docs/keygen.txt b/docs/keygen.txt
index dffa143..65b5122 100644
--- a/docs/keygen.txt
+++ b/docs/keygen.txt
@@ -7,7 +7,6 @@ http://www.eecis.udel.edu/%7emills/pictures.html[from 'Alice's Adventures in Won
Alice holds the key.
-Last update: 10-Mar-2014 05:11 UTC
|==============================
== Related Links ==
diff --git a/docs/leap.txt b/docs/leap.txt
index 8842047..c6bc331 100644
--- a/docs/leap.txt
+++ b/docs/leap.txt
@@ -1,9 +1,5 @@
= Leap Second Processing =
-Last update: 10-Mar-2014 05:11 UTC
-
-'''''
-
About every eighteen months the International Earth Rotation Service
(IERS) issues a bulletin announcing the insertion of a leap second in
the Universal Coordinated Time (UTC) timescale. Ordinarily, this happens
diff --git a/docs/miscopt.txt b/docs/miscopt.txt
index 23087f0..e0be0bb 100644
--- a/docs/miscopt.txt
+++ b/docs/miscopt.txt
@@ -7,7 +7,6 @@
We have three, now looking for more.
-Last update: 28-Feb-2015 12:01 UTC
|==============================
== Related Links ==
diff --git a/docs/monopt.txt b/docs/monopt.txt
index f6ab634..c1a1b3c 100644
--- a/docs/monopt.txt
+++ b/docs/monopt.txt
@@ -7,7 +7,6 @@ from 'Pogo', Walt Kelly
Pig was hired to watch the logs.
-Last update: 31-Jan-2014 06:54 UTC
|==============================
== Related Links ==
diff --git a/docs/msyslog.txt b/docs/msyslog.txt
index 46bd4f8..5ecc534 100644
--- a/docs/msyslog.txt
+++ b/docs/msyslog.txt
@@ -8,7 +8,6 @@
The log can be shrill at times.
-Last update: 10-Mar-2014 05:12 UTC
|==============================
== Related Links ==
@@ -78,8 +77,7 @@ meaning should be clear from context.
`sigaction() fails to save SIGSYS trap: ?`::
`sigaction() fails to restore SIGSYS trap: ?`::
-//ERROR: I suspect this program error line should be indented
-Program error. Bugs can be reported link:bugs.html[here].::
+ Program error. Bugs can be reported link:bugs.html[here].::
--
=== LOG_NOTICE ===
diff --git a/docs/mx4200data.txt b/docs/mx4200data.txt
index fa20702..64588e0 100644
--- a/docs/mx4200data.txt
+++ b/docs/mx4200data.txt
@@ -1,9 +1,5 @@
= MX4200 Receiver Data Format =
-Last update: 21-Oct-2010 23:44 UTC
-
-'''''
-
== Table of Contents ==
* link:#control[Control Port Sentences]
* link:#input[Control Port Input Sentences]
diff --git a/docs/ntp_conf.txt b/docs/ntp_conf.txt
index 8154e2d..f253e04 100644
--- a/docs/ntp_conf.txt
+++ b/docs/ntp_conf.txt
@@ -7,7 +7,6 @@
Racoon is shooting configuration bugs.
-Last update: 4-Oct-2010 05:13 UTC
|==============================
== Table of Contents ==
diff --git a/docs/ntpd-body.txt b/docs/ntpd-body.txt
index 91532d0..624f1f7 100644
--- a/docs/ntpd-body.txt
+++ b/docs/ntpd-body.txt
@@ -161,7 +161,7 @@ configuration file _interface_ command, which is more versatile.
`-k` string, `--keyfile`=_string_::
path to symmetric keys.
+
-Specify the name and path of the symmetric key file. `/etc/ntp.keys`
+Specify the name and path of the symmetric key file. `/etc/{ntpkeys}`
is the default. This is the same operation as the _keys_
configuration file directive.
diff --git a/docs/ntpd.txt b/docs/ntpd.txt
index f239979..120a325 100644
--- a/docs/ntpd.txt
+++ b/docs/ntpd.txt
@@ -7,7 +7,6 @@
You need help from the monkeys.
-Last update: 10-Mar-2014 05:14 UTC
|==============================
diff --git a/docs/ntpdsim.txt b/docs/ntpdsim.txt
index 5f17eed..92ef35a 100644
--- a/docs/ntpdsim.txt
+++ b/docs/ntpdsim.txt
@@ -7,7 +7,6 @@ http://www.eecis.udel.edu/%7emills/pictures.html[from 'The Wizard of Oz', L. Fra
All in a row.
-Last update: 11-Sep-2010 05:55 UTC
|==============================
== Related Links ==
@@ -102,6 +101,7 @@ options apply also to `ntpdsim`. In addition, the following command line
[[files]]
== Files ==
+//NAMECHANGE
`/etc/ntp.conf` - the default name of the configuration file +
`/etc/ntp.drift` - the default name of the drift file +
`/etc/ntp.keys` - the default name of the key file
diff --git a/docs/ntpdsim_new.txt b/docs/ntpdsim_new.txt
index 1709fc0..b729885 100644
--- a/docs/ntpdsim_new.txt
+++ b/docs/ntpdsim_new.txt
@@ -7,7 +7,6 @@ http://www.eecis.udel.edu/%7emills/pictures.html[from 'The Wizard of Oz', L. Fra
All in a row.
-Last update: 31-Jan-2014 06:54 UTC
|==============================
diff --git a/docs/ntpq-body.txt b/docs/ntpq-body.txt
index 879d3e5..c0d84cd 100644
--- a/docs/ntpq-body.txt
+++ b/docs/ntpq-body.txt
@@ -446,7 +446,7 @@ The jitter and wander statistics are exponentially-weighted RMS
averages. The system jitter is defined in the NTPv4 specification; the
clock jitter statistic is computed by the clock discipline module.
-When the NTPv4 daemon is compiled with the OpenSSL software library,
+When {ntpd} is compiled with the OpenSSL software library,
additional system variables are displayed, including some or all of the
following, depending on the particular Autokey dance:
@@ -508,7 +508,7 @@ appears only the interleaved symmetric and interleaved modes. It
represents the internal queuing, buffering and transmission delays for
the preceding packet.
-When the NTPv4 daemon is compiled with the OpenSSL software library,
+When {ntpd} is compiled with the OpenSSL software library,
additional peer variables are displayed, including the following:
[width="100%",cols="<20%,<80%"]
diff --git a/docs/ntpq.txt b/docs/ntpq.txt
index 69959ea..fd7882f 100644
--- a/docs/ntpq.txt
+++ b/docs/ntpq.txt
@@ -7,7 +7,6 @@
A typical NTP monitoring packet
-Last update: 31-Jan-2014 06:54 UTC
|==============================
== More Help ==
diff --git a/docs/ntptime.txt b/docs/ntptime.txt
index 4305d50..88afe0f 100644
--- a/docs/ntptime.txt
+++ b/docs/ntptime.txt
@@ -7,7 +7,6 @@
The turtle has been swimming in the kernel.
-Last update: 11-Sep-2010 05:55 UTC
|==============================
'''''
diff --git a/docs/ntptrace.txt b/docs/ntptrace.txt
index 34e0f4b..2d3b1d6 100644
--- a/docs/ntptrace.txt
+++ b/docs/ntptrace.txt
@@ -7,7 +7,6 @@
The rabbit knows the way back.
-Last update: 31-Jan-2014 06:54 UTC
|==============================
'''''
diff --git a/docs/oncore-shmem.txt b/docs/oncore-shmem.txt
index afa8816..b1f824b 100644
--- a/docs/oncore-shmem.txt
+++ b/docs/oncore-shmem.txt
@@ -1,9 +1,5 @@
= Motorola ONCORE - The Shared Memory Interface =
-Last update: 21-Oct-2010 23:44 UTC
-
-'''''
-
== Introduction ==
In NMEA mode, the Oncore GPS receiver provides the user with the same
@@ -18,7 +14,7 @@ can see the raw satellite data messages themselves.
When using the Oncore GPS receiver with NTP, this additional information
is usually not available since the receiver is only talking to the
-oncore driver in NTPD. To make this information available for use in
+oncore driver in _{ntpd}_. To make this information available for use in
other programs, (say graphic displays of satellites positions, plots of
SA, etc.), a shared memory interface (SHMEM) has been added to the
refclock_oncore driver on those operating systems that support shared
diff --git a/docs/orphan.txt b/docs/orphan.txt
index d35c574..3e769cf 100644
--- a/docs/orphan.txt
+++ b/docs/orphan.txt
@@ -1,9 +1,5 @@
= Orphan Mode =
-Last update: 4-Aug-2011 23:40 UTC
-
-'''''
-
Sometimes an NTP subnet becomes isolated from all UTC sources such as
local reference clocks or Internet time servers. In such cases it may be
necessary that the subnet servers and clients remain synchronized to a
diff --git a/docs/parsedata.txt b/docs/parsedata.txt
index 88b572a..8ad5d07 100644
--- a/docs/parsedata.txt
+++ b/docs/parsedata.txt
@@ -6,8 +6,6 @@ clock you might want to integrate into parse. I'll sum up the major
features of the clocks (this information is distributed in the
parse/clk_*.c and {ntpd}/refclock_parse.c files).
-Last update: 21-Oct-2010 23:44 UTC
-
'''''
== Meinberg clocks ==
diff --git a/docs/parsenew.txt b/docs/parsenew.txt
index 08575c0..b561ea3 100644
--- a/docs/parsenew.txt
+++ b/docs/parsenew.txt
@@ -5,8 +5,6 @@ another clock to the parse driver: Currently the implementation is being
cleaned up - so not all information in here is completely correct. Refer
to the included code where in doubt.
-Last update: 13-Oct-2010 00:33 UTC
-
Prerequisites:
* Does the system you want the clock connect to have the include file
diff --git a/docs/poll.txt b/docs/poll.txt
index 26186aa..44a4d84 100644
--- a/docs/poll.txt
+++ b/docs/poll.txt
@@ -1,9 +1,5 @@
= Poll Process =
-Last update: 10-Mar-2014 05:17 UTC
-
-'''''
-
The poll process sends NTP packets at intervals determined by the clock
discipline algorithm. The process is designed to provide a sufficient
update rate to maximize accuracy while minimizing network overhead. The
diff --git a/docs/pps.txt b/docs/pps.txt
index b1c5899..075f872 100644
--- a/docs/pps.txt
+++ b/docs/pps.txt
@@ -7,7 +7,6 @@
Alice is trying to find the PPS signal connector.
-Last update: 22-MSep-2015 05:12 UTC
|==============================
== Related Links ==
@@ -39,7 +38,7 @@ algorithms can whittle this down to a few tens of
microseconds. However, some time sources produce a pulse-per-second
(PPS) signal which can be used to improve the accuracy to a few
microseconds. This page describes the hardware and software necessary
-for NTP to use the PPS signal.
+for {ntpd} to use the PPS signal.
The simplest way to collect a PPS signal is from a GPS over a serial
handshake pin, typically DCD; Linux supports this. On FreeBSD systems
diff --git a/docs/prefer.txt b/docs/prefer.txt
index a10e580..7ed093a 100644
--- a/docs/prefer.txt
+++ b/docs/prefer.txt
@@ -7,7 +7,6 @@ http://www.eecis.udel.edu/%7emills/pictures.html[from 'Alice's Adventures in Won
Listen carefully to what I say; it is very complicated.
-Last update: 10-Mar-2014 05:18 UTC
|==============================
== Related Links ==
diff --git a/docs/quick.txt b/docs/quick.txt
index 5d63b69..54353b6 100644
--- a/docs/quick.txt
+++ b/docs/quick.txt
@@ -3,8 +3,6 @@
.FAX test image for SATNET (1979).
image:pic/panda.gif[]
-Last update: 1-Dec-2012 04:44 UTC
-
The baby panda was scanned at University College London and used as a
FAX test image for a demonstration of the DARPA Atlantic SATNET Program
and the first transatlantic Internet connection in 1978. The computing
@@ -15,8 +13,6 @@ and the first to use a predecessor of NTP in regular operation. The
image was widely copied and used for testing purpose throughout much of
the 1980s.
-Last update: 1-Dec-2012 04:44 UTC
-
== Related Links ==
include::includes/install.txt[]
diff --git a/docs/rate.txt b/docs/rate.txt
index 5fc44b5..0420c49 100644
--- a/docs/rate.txt
+++ b/docs/rate.txt
@@ -7,7 +7,6 @@ http://www.eecis.udel.edu/%7emills/pictures.html[from 'Pogo', Walt Kelly]
Our junior managers and the administrators.
-Last update: 10-Mar-2014 05:19 UTC
|==============================
== Related Links ==
diff --git a/docs/rdebug.txt b/docs/rdebug.txt
index 0a99e07..ba777d6 100644
--- a/docs/rdebug.txt
+++ b/docs/rdebug.txt
@@ -7,7 +7,6 @@
Call the girls and they'll sweep your bugs.
-Last update: 10-Mar-2014 05:19 UTC
|==============================
== Related Links ==
diff --git a/docs/select.txt b/docs/select.txt
index 2813690..02d93d7 100644
--- a/docs/select.txt
+++ b/docs/select.txt
@@ -1,10 +1,6 @@
= Clock Select Algorithm =
-Last update: 10-Mar-2014 05:22 UTC
-
-'''''
-
-The clock select algorithm determines from a set of sources , which are
+The clock select algorithm determines from a set of sources, which are
correct (_truechimers_) and which are not (_falsetickers_) according to
a set of formal correctness assertions. The principles are based on the
observation that the maximum error in determining the offset of a
diff --git a/docs/sntp-body.txt b/docs/sntp-body.txt
index f1d4e9e..44bdd0a 100644
--- a/docs/sntp-body.txt
+++ b/docs/sntp-body.txt
@@ -124,7 +124,7 @@ message will be displayed. The file will not be created.
Look in this file for the key specified with `-a`.
+
This option specifies the keyfile. `sntp` will search for the key
-specified with `-a` keyno in this file. See _ntp.keys(5)_ for more
+specified with `-a` keyno in this file. See _{ntpkeysman}_ for more
information.
`-l` file-name, `--logfile`=_file-name_::
diff --git a/docs/stats.txt b/docs/stats.txt
index a2048ce..0c57d67 100644
--- a/docs/stats.txt
+++ b/docs/stats.txt
@@ -1,7 +1,5 @@
= Performance Metrics =
-Last update: 10-Mar-2014 05:23 UTC
-
== Related Links ==
include::includes/special.txt[]
diff --git a/docs/tf582_4.txt b/docs/tf582_4.txt
index e956272..6a141b3 100644
--- a/docs/tf582_4.txt
+++ b/docs/tf582_4.txt
@@ -1,9 +1,5 @@
= European Automated Computer Time Services =
-Last update: 21-Oct-2010 23:44 UTC
-
-'''''
-
Several European countries use the following message data format:
diff --git a/docs/tickadj.txt b/docs/tickadj.txt
index c074e6b..561227f 100644
--- a/docs/tickadj.txt
+++ b/docs/tickadj.txt
@@ -1,9 +1,5 @@
= `tickadj` - set time-related kernel variables =
-Last update: 16-Sep-2015
-
-'''''
-
== Synopsis ==
`tickadj [ -Aqs ] [ -a tickadj ] [ -t tick ]`
diff --git a/docs/warp.txt b/docs/warp.txt
index d81f8b5..607e9d9 100644
--- a/docs/warp.txt
+++ b/docs/warp.txt
@@ -1,7 +1,5 @@
= How NTP Works =
-Last update: 10-Mar-2014 05:24 UTC
-
== Related Links ==
include::includes/special.txt[]
diff --git a/docs/xleave.txt b/docs/xleave.txt
index 6aa0829..356f4fd 100644
--- a/docs/xleave.txt
+++ b/docs/xleave.txt
@@ -7,7 +7,6 @@ http://www.eecis.udel.edu/%7emills/pictures.html[from 'Pogo', Walt Kelly]
You need a little magic.
-Last update: 10-Mar-2014 05:25 UTC
|==============================
'''''
diff --git a/ntp-keygen/ntp-keygen.c b/ntp-keygen/ntp-keygen.c
index 3536f21..9fa83a7 100644
--- a/ntp-keygen/ntp-keygen.c
+++ b/ntp-keygen/ntp-keygen.c
@@ -2314,6 +2314,7 @@ fheader (
perror("Write");
exit (-1);
}
+ /* NAMECHANGE */
if (strcmp(ulink, "md5") == 0) {
strlcpy(linkname,"ntp.keys",sizeof(linkname));
} else {
diff --git a/ntpd/ntp.conf.txt b/ntpd/ntp.conf.txt
index 26e21c1..78186a5 100644
--- a/ntpd/ntp.conf.txt
+++ b/ntpd/ntp.conf.txt
@@ -345,7 +345,7 @@ The original RFC-1305 specification allows any one of possibly 65,534
keys, each distinguished by a 32-bit key identifier, to authenticate an
association. The servers and clients involved must agree on the key and
key identifier to authenticate NTP packets. Keys and related information
-are specified in a key file, usually called _ntp.keys_, which must be
+are specified in a key file, usually called _{ntpkeys}_, which must be
distributed and stored using secure means beyond the scope of the NTP
protocol itself. Besides the keys used for ordinary NTP associations,
additional keys can be used as passwords for the {ntpqman}
@@ -1658,6 +1658,7 @@ started.
== FILES ==
+//NAMECHANGE
`/etc/ntp.conf`::
the default name of the configuration file
_ntp.keys_::
diff --git a/ntpd/ntp.keys.txt b/ntpd/ntp.keys.txt
index 69282fe..6ed25aa 100644
--- a/ntpd/ntp.keys.txt
+++ b/ntpd/ntp.keys.txt
@@ -2,7 +2,7 @@
:doctype: manpage
== NAME ==
-ntp.keys - NTP symmetric key file format configuration file
+{ntpkeys} - NTP symmetric key file format configuration file
== DESCRIPTION ==
@@ -10,7 +10,7 @@ This document describes the format of an NTP symmetric key file. For a
description of the use of this type of file, see the "Authentication
Support" section of the ntp.conf(5) page.
-ntpd(8) reads its keys from a file specified using the -k command line
+{ntpdman} reads its keys from a file specified using the -k command line
option or the 'keys' statement in the configuration file. While key
number 0 is fixed by the NTP standard (as 56 zero bits) and may not be
changed, one or more keys numbered between 1 and 65534 may be
@@ -49,26 +49,11 @@ format.
== FILES ==
-`/etc/ntp.keys`::
+`/etc/{ntpkeys}`::
the default name of the configuration file
== SEE ALSO ==
-ntp.conf(5), ntpd(1), ntpdate(1), ntpq(1), sntp(1).
+{ntpconfman}, {ntpdman}, {ntpqman}, {sntpman}.
-== AUTHORS ==
-
-//FIXME: ntp.org reference
-The University of Delaware and Network Time Foundation
-
-== COPYRIGHT ==
-
-//FIXME: NTF reference
-Copyright (C) 1992-2015 The University of Delaware and Network Time
-Foundation all rights reserved. This program is released under the terms
-of the NTP license, <http://ntp.org/license>.
-
-== BUGS ==
-
-//FIXME: ntp.org reference
-Please send bug reports to: http://bugs.ntp.org, bugs at ntp.org
+// end
More information about the vc
mailing list