]> git.ipfire.org Git - thirdparty/ntp.git/commitdiff
Many files:
authorHarlan Stenn <stenn@ntp.org>
Fri, 13 Apr 2001 05:04:57 +0000 (05:04 -0000)
committerHarlan Stenn <stenn@ntp.org>
Fri, 13 Apr 2001 05:04:57 +0000 (05:04 -0000)
  * html/pic/radio2.jpg:
  * html/release.htm:
  * html/refclock.htm:
  * html/pps.htm:
  * html/ntpd.htm:
  * html/miscopt.htm:
  * html/driver22.htm:
  * html/confopt.htm:
  Updated documentation from Dave Mills.

bk: 3ad688f9wM0Tlkh4pCb9iT69U1BEyw

ChangeLog
html/confopt.htm
html/driver22.htm
html/miscopt.htm
html/ntpd.htm
html/pic/radio2.jpg [new file with mode: 0644]
html/pps.htm
html/refclock.htm
html/release.htm

index 5b78668f299b2353ad9a30af55a143d2acdd521a..cb5acc2c3809a99ab200189b51c6018a57e64d5c 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,15 @@
 2001-04-13  Harlan Stenn  <stenn@whimsy.udel.edu>
 
+       * html/pic/radio2.jpg:
+       * html/release.htm:
+       * html/refclock.htm:
+       * html/pps.htm:
+       * html/ntpd.htm:
+       * html/miscopt.htm:
+       * html/driver22.htm:
+       * html/confopt.htm:
+       Updated documentation from Dave Mills.
+
        * util/ntp-genkeys.c: sys_minpoll.
        * ntpd/refclock_atom.c: Comment additions.
        * ntpd/ntp_proto.c: mode_ntpdate and peer_ntpdate added.
index 33a1b3f20f618f32634aabb7010412e9f08f0677..cb9fe8f03c35a4413a20c512ac5d30f67d5d44e1 100644 (file)
@@ -163,10 +163,14 @@ default is to include no encryption field.</dd>
 <dt><tt>minpoll <i>minpoll</i></tt><br>
 <tt>maxpoll <i>maxpoll</i></tt></dt>
 
-<dd>These options specify the minimum and maximum polling intervals
-for NTP messages, in seconds to the power of two. The default range
-is 6 (64 s) to 10 (1,024 s). The allowable range is 4 (16 s) to 17
-(36.4 h) inclusive.</dd>
+<dd>These options specify the minimum and maximum poll intervals
+for NTP messages, in seconds to the power of two. The maximum poll
+interval defaults to 10 (1,024 s), but can be increased by the <tt>
+maxpoll</tt> option to an upper limit of 17 (36.4 h). The minimum
+poll interval defaults to 6 (64 s), but can be decreased by the
+<tt>minpoll</tt> option to a lower limit set by the <tt>tinker
+minpoll</tt> command. The limit set by this command defaults to 6
+(64 s), but can be decreased to a lower limit of 4 (16s).</dd>
 
 <dt><tt>prefer</tt></dt>
 
index e22b3b0ce7af1545438fcaa27a9f2d3861d5d323..a293cbc92c649f13d0b07d7cffa8936e7d152cc0 100644 (file)
@@ -20,7 +20,8 @@ Requires: PPSAPI interface
 older driver operated with several somewhat archaic signal
 interface devices, required intricate configuration and was poorly
 documented. This driver operates only with the PPSAPI interface
-proposed as an IETF standard.</p>
+proposed as an IETF standard. Note also that the <tt>pps</tt>
+configuration command has been obsoleted by this driver.</p>
 
 <h4>Description</h4>
 
@@ -55,7 +56,7 @@ for this interface is included in current versions of FreeBSD and
 Linux and proprietary versions for Digital/Compaq Tru64 (Alpha),
 Sun Solaris and Sun SunOS. See the <a href="pps.htm">
 Pulse-per-second (PPS) Signal Interfacing</a> page for further
-information</p>
+information.</p>
 
 <p>The PPS source can be connected via a serial or parallel port,
 depending on the hardware and operating system. The port can be
@@ -68,8 +69,20 @@ signal can be connected directly to the ACK pin (pin 10) of the
 connector. Whether the PPS signal is connected via a dedicated port
 or shared with another device, the driver opens the device <tt>
 /dev/pps%d</tt>, where <tt>%d</tt> is the unit number. As with
-other drivers, links can be used to redirect the logical name can
-be redirected to the actual physical device.</p>
+other drivers, links can be used to redirect the logical name to
+the actual physical device.</p>
+
+<p>The driver normally operates like any other driver and uses the
+same mitigation algorithms and PLL/FLL clock discipline
+incorporated in the daemon. If kernel PLL/FLL support is available,
+the kernel PLL/FLL clock discipline is used instead. The default
+behavior is not to use the kernel PPS clock discipline, even if
+present. This driver incorporates a good deal of signal processing
+to reduce jitter using the median filter and trimmed average
+algorithms in the driver interface. As the result, performance with
+minpoll and maxpoll configured at the minimum 4 (16s) is generally
+better than the kernel PPS clock discipline. However, fudge flag 3
+can be used to enable this discipline if necessary.</p>
 
 <p>Note that the PPS source is considered reachable only if the
 auxiliary source is the prefer peer, is reachable and is selected
index 082728a94f96d6e46d75e25160099b4dbbeb032d..c6e935d7653b0a8efce44218786356dd1f08ef35 100644 (file)
@@ -182,10 +182,11 @@ the names of all peer variables and the <tt>clock_var_list</tt>
 holds the names of the reference clock variables.</dd>
 
 <dt><tt>tinker [ step <i>step</i> | panic <i>panic</i> | dispersion
-<i>dispersion</i> | stepout <i>stepout</i> ]</tt></dt>
+<i>dispersion</i> | stepout <i>stepout</i> | minpoll <i>minpoll</i>
+]</tt></dt>
 
 <dd>This command can be used to alter several system variables in
-very exceptional circumstances. The default values of these
+very exceptional circumstances. It should occur in the configuration file before any other configuration options. The default values of these
 variables have been carefully optimized for a wide range of network
 speeds and reliability expectations. In general, they interact in
 intricate ways that are hard to predict and some combinations can
@@ -196,7 +197,7 @@ twisters are on their own and can expect no help from the support
 group. 
 
 <p>All arguments are in floating point seconds or seconds per
-second. The variables operate as follows:</p>
+second. The <tt>minpoll</tt> argument is an integer in seconds to the power of two. The variables operate as follows:</p>
 </dd>
 
 <dd>
@@ -220,6 +221,12 @@ rate, normally .000015.</dd>
 
 <dd>The argument becomes the new value for the watchdog timeout,
 normally 900 s.</dd>
+
+<dt><tt>minpoll <i>minpoll</i></tt></dt>
+
+<dd>The argument becomes the new value for the default minimum poll
+interval, normally 6 (64 s). The value may not be less than 4 (16
+s).</dd>
 </dl>
 </dd>
 
index 6c026deac53fd1a0fd0afe44d5b3f169dca95c07..6837005c9073bce742f1a679e4803eec20214d2b 100644 (file)
@@ -193,6 +193,40 @@ stopped and run in one-time mode as required. At each startup, the
 frequency is read from the file and initializes the kernel
 frequency.</p>
 
+<h4>Poll Interval Control</h4>
+
+<p>This version of NTP includes an intricate state machine to
+reduce the network load while maintaining a quality of
+synchronization consistent with the observed jitter and wander.
+There are a number of ways to tailor the operation in order enhance
+accuracy by reducing the interval or to reduce network overhead by
+increasing it. However, the user is advised to carefully consider
+the consequenses of changing the poll adjustment range from the
+default minimum of 64 s to the default maximum of 1,024 s. The
+default minimum can be changed with the <tt>tinker minpoll</tt>
+command to a value not less than 16 s. This value is used for all
+configured associations, unless overriden by the <tt>minpoll</tt>
+option on the configuration command. Note that most device drivers
+will not operate properly if the poll interval is less than 64 s
+and that the broadcast server and manycast client associations will
+also use the default, unless overriden.</p>
+
+<p>In some cases involving dial up or toll services, it may be
+useful to increase the minimum interval to a few tens of minutes
+and maximum interval to a day or so. Under normal operation
+conditions, once the clock discipline loop has stabilized the
+interval will be increased in steps from the minumum to the
+maximum. However, this assumes the intrinsic clock frequency error
+is small enough for the discipline loop correct it. The capture
+range of the loop is 500 PPM at an interval of 64s decreasing by a
+factor of two for each doubling of interval. At a minimum of 1,024
+s, for example, the capture range is only 31 PPM. If the intrinsic
+error is greater than this, the drift file <tt>ntp.drift</tt> will
+have to be specially tailored to reduce the residual error below
+this limit. Once this is done, the drift file is automatically
+updated once per hour and is available to initialize the frequency
+on subsequent daemon restarts.</p>
+
 <h4>Notes</h4>
 
 <p>If NetInfo support is built into <tt>ntpd</tt>, then <tt>
diff --git a/html/pic/radio2.jpg b/html/pic/radio2.jpg
new file mode 100644 (file)
index 0000000..ceb7c76
Binary files /dev/null and b/html/pic/radio2.jpg differ
index 1c98ce8ed4d123a1e8dd2289c8d2e525f7ecb75f..a20dd4d744eabcb5356809f0cafe02eddef39f92 100644 (file)
@@ -34,7 +34,7 @@ connection via the data leads of a serial port.</p>
 system support, which is available in only a few operating systems,
 including Linux, FreeBSD and latest Solaris beginning with 2.7.
 Support on an experimental basis is available for several older
-systems, including SunOS, Digital RISC and HP-UX, and in current
+systems, including SunOS, Digital Ultrix and HP-UX, and in current
 Digital Tru64 (Alpha). The PPS application program interface
 defined in RFC-2783 (PPSAPI) is the only interface currently
 supported. Older PPS interfaces based on the <tt>ppsclock</tt> and
@@ -42,16 +42,17 @@ supported. Older PPS interfaces based on the <tt>ppsclock</tt> and
 PPSAPI is expected to become an IETF cross-platform standard, it
 should be used by new applications.</p>
 
-<p>The PPSAPI inerface requires a <tt>/usr/include/ppstime.h</tt>
-header file. This file is included in Linux and FreeBSD
-distributions, but not in other distributions or standard
-workstation products at this time. Header files for other systems,
-including Solaris, can be found in the <tt>nanokernel.tar.gz</tt>
-distribution, which can be found via the Collaboration Resources
-link at www.ntp.org. The top level directory contains a number of
-subdirectories for each architecture, including Solaris. The <tt>
-ppstime.h</tt> file for each architecture can be found in the
-subdirectory of the same name.</p>
+<p>The PPSAPI inerface requires a <tt>
+/usr/include/sys/ppstime.h</tt> header file. This file is included
+in Linux and FreeBSD distributions, but not in other distributions
+or standard workstation products at this time. Header files for
+other systems, including Solaris, can be found in the <tt>
+nanokernel.tar.gz</tt> distribution, which can be found via the
+Collaboration Resources link at www.ntp.org. The top level
+directory contains a number of subdirectories for each
+architecture, including Solaris. The <tt>ppstime.h</tt> file for
+each architecture can be found in the subdirectory of the same
+name.</p>
 
 <p>In the preferred mode of operation, PPS signals are processed by
 the <a href="driver22.htm">PPS Clock Discipline</a> driver and
@@ -59,7 +60,9 @@ other clock drivers which might be involved need not know or care
 about them. In some cases where there is no other driver, time
 might be obtained from remote NTP servers via the network and local
 PPS signals, for instance from a calibrated cesium oscillator, used
-to stabilize the frequency and remove network jitter.</p>
+to stabilize the frequency and remove network jitter. Note that the
+<tt>pps</tt> configuration command has been obsoleted by this
+driver.</p>
 
 <p>The PPS driver operates in conjunction with a preferred peer, as
 described in the <a href="prefer.htm">Mitigation Rules and the <tt>
@@ -72,13 +75,16 @@ as described in that page in order to provide the most accurate
 time, while respecting the various types of equipment failures that
 could happen.</p>
 
-<p>For the utmost time quality, some Unix system kernels support a
-PPS signal directly, as described in the <a href="kern.htm">A
-Kernel Model for Precision Timekeeping</a> page. Specifically, the
-PPS driver can be used to direct the PPS signal to the kernel for
-use as a discipline source for both time and frequency. The
-presence of the kernel support is automatically detected during the
-NTP build process and supporting code automatically compiled.</p>
+<p>Some Unix system kernels support a PPS signal directly, as
+described in the <a href="kern.htm">A Kernel Model for Precision
+Timekeeping</a> page. Specifically, the PPS driver can be used to
+direct the PPS signal to the kernel for use as a discipline source
+for both time and frequency. The presence of the kernel support is
+automatically detected during the NTP build process and supporting
+code automatically compiled. Note that the PPS driver does not
+normally enable the PPS kernel code, since performance is generally
+better without it. However, this code can be enabled by a driver
+fudge flag if necessary.</p>
 
 <p>Some configurations may include multiple radio clocks with
 individual PPS outputs. In some PPSAPI designs multiple PPS signals
index cb16ce4b949d48f6d7e78974a50bc146530eef0b..1789ac30964ed8746d1755c81c78631ee13fe5ac 100644 (file)
-<html><head><title>
-Reference Clock Drivers
-</title></head><body><h3>
-Reference Clock Drivers
-</H3>
-
-<img align=left src=pic/stack1a.jpg>Master Time Facility at the <a href=http://www.eecis.udel.edu/~mills/lab.htm>UDel Internet Research Laboratory</a>:
-
-<br clear=left><hr>
-
-Support for most of the commonly available radio and modem reference clocks is included in the default configuration of the NTP daemon for Unix <tt>ntpd</tt>. Individual clocks can be activated by configuration file commands, specifically the <tt>server</tt> and <tt>fudge</tt> commands described in the <a href=ntpd.htm><tt>ntpd</tt> program manual page</a>. The following discussion presents Information on how to select and configure the device drivers in a running Unix system.
-
-<p>Radio and modem clocks by convention have addresses in the form 127.127.<I>t.u</I>, where <I>t</I> is the clock type and <I>u</I> is a unit number in the range 0-3 used to distinguish multiple instances of clocks of the same type. Most of these clocks require support in the form of a serial port or special bus peripheral, but some can work directly from the audio codec found in some workstations. The particular device is normally specified by adding a soft link <tt>/dev/device<I>u</I></tt> to the particular hardware device involved, where <I><tt>u</tt></I> correspond to the unit number above.
-
-<p>Most clock drivers communicate with the reference clock using a serial port, usually at 9600 bps. There are several application program interfaces (API) used in the various Unix and NT systems, most of which can be detected at configuration time. Thus, it is important that the NTP daemon and utilities be compiled on the target system or clone. In some cases special features are available, such as timestamping in the kernel or pulse-per-second (PPS) interface. In most cases these features can be detected at configuration time as well; however, the kernel may have to be recompiled in order for them to work.
-
-<p>The audio drivers are a special case. These include support for the NIST time/frequency stations WWV and WWVH, the Canadian time/frequency station CHU and generic IRIG signals. Currently, support for the Solaris and SunOS audio API is included in the distribution. It is left to the volunteer corps to extend this support to other systems. Further information on hookup, debugging and monitoring is given in the <a
-href=audio.htm>Audio Drivers</a> page.
-
-<p>The local clock driver is also a special case. A server configured with this driver can operate as a primary server to synchronize other clients when no other external synchronization sources are available. If the server is connected directly or indirectly to the public Internet, there is some danger that it can adversely affect the operation of unrelated clients. Carefully read the <a href=driver1.htm>Undisciplined Local Clock</a> page and respect the stratum limit.
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<html>
+<head>
+<meta name="generator" content="HTML Tidy, see www.w3.org">
+<title>Reference Clock Drivers</title>
+</head>
+<body>
+<h3>Reference Clock Drivers</h3>
+
+<img align="left" src="pic/stack1a.jpg" alt="gif">Master Time
+Facility at the <a href="http://www.eecis.udel.edu/~mills/lab.htm">
+UDel Internet Research Laboratory</a>: <br clear="left">
+<hr>
+<p>Support for most of the commonly available radio and modem
+reference clocks is included in the default configuration of the
+NTP daemon for Unix <tt>ntpd</tt>. Individual clocks can be
+activated by configuration file commands, specifically the <tt>
+server</tt> and <tt>fudge</tt> commands described in the <a href=
+"ntpd.htm"><tt>ntpd</tt> program manual page</a>. The following
+discussion presents Information on how to select and configure the
+device drivers in a running Unix system.</p>
+
+<p>Many radio reference clocks can be set to display local time as
+adjusted for timezone and daylight saving mode. For use with NTP
+the clock must be set for Coordinated Universal Time (UTC) only.
+Ordinarily, these adjustments are performed by the kernel, so the
+fact that the clock runs on UTC will be transparent to the
+user.</p>
+
+<p>Radio and modem clocks by convention have addresses in the form
+127.127.<i>t.u</i>, where <i>t</i> is the clock type and <i>u</i>
+is a unit number in the range 0-3 used to distinguish multiple
+instances of clocks of the same type. Most of these clocks require
+support in the form of a serial port or special bus peripheral, but
+some can work directly from the audio codec found in some
+workstations. The particular device is normally specified by adding
+a soft link <tt>/dev/device<i>u</i></tt> to the particular hardware
+device involved, where <i><tt>u</tt></i> correspond to the unit
+number above.</p>
+
+<p>Most clock drivers communicate with the reference clock using a
+serial port, usually at 9600 bps. There are several application
+program interfaces (API) used in the various Unix and NT systems,
+most of which can be detected at configuration time. Thus, it is
+important that the NTP daemon and utilities be compiled on the
+target system or clone. In some cases special features are
+available, such as timestamping in the kernel or pulse-per-second
+(PPS) interface. In most cases these features can be detected at
+configuration time as well; however, the kernel may have to be
+recompiled in order for them to work.</p>
+
+<p>The audio drivers are a special case. These include support for
+the NIST time/frequency stations WWV and WWVH, the Canadian
+time/frequency station CHU and generic IRIG signals. Currently,
+support for the Solaris and SunOS audio API is included in the
+distribution. It is left to the volunteer corps to extend this
+support to other systems. Further information on hookup, debugging
+and monitoring is given in the <a href="audio.htm">Audio
+Drivers</a> page.</p>
+
+<p>The local clock driver is also a special case. A server
+configured with this driver can operate as a primary server to
+synchronize other clients when no other external synchronization
+sources are available. If the server is connected directly or
+indirectly to the public Internet, there is some danger that it can
+adversely affect the operation of unrelated clients. Carefully read
+the <a href="driver1.htm">Undisciplined Local Clock</a> page and
+respect the stratum limit.</p>
 
 <h4>Driver Calibration</h4>
 
-<p>Some drivers depending on longwave and shortwave radio services need to know the radio propagation time from the transmitter to the receiver, which can amount to some tens of milliseconds. This must be calculated for each specific receiver location and requires the geographic coordinates of both the transmitter and receiver. The transmitter coordinates for various radio services are given in the <a href=qth.htm>Stations, Frequencies and Geographic Coordinates</a> page. Receiver coordinates can be obtained or estimated from various sources. The actual calculations are beyond the scope of this document.
-
-<p>When more than one clock driver is supported, it is often the case that each shows small systematic offset differences relative to the rest. To reduce the effects of jitter when switching from one driver to the another, it is useful to calibrate the drivers to a common ensemble offset. The <tt>enable calibrate</tt> configuration command in the <a href=miscopt.htm>Miscellaneous Options</a> page is useful for this purpose. The calibration function can also be enabled and disabled using the <tt>ntpdc</tt> program utility.
-
-<p>Most clock drivers use the <tt>time1</tt> value specified in the <tt>fudge</tt> configuration command to provide the calibration correction when this cannot be provided by the clock or interface. When the calibration function is enabled, the <tt>time1</tt> value is automatically adjusted to match the offset of the remote server or local clock driver selected for synchronization. Ordinarily, the NTP selection algorithm chooses the best from among all sources, usually the best radio clock determined on the basis of stratum, synchronization distance and jitter. The calibration function adjusts the <tt>time1</tt> values for all clock drivers except this source so that their indicated offsets tend to zero. If the selected source is the kernel PPS discipline, the <tt>fudge time1</tt> values for all clock drivers are adjusted.
-
-<p>The adjustment function is an exponential average designed to improve accuracy, so the function takes some time to converge. The recommended procedure is to enable the function, let it run for an hour or so, then edit the configuration file using the <tt>time1</tt> values displayed by the <tt>ntpq</tt> utility and <tt>clockvar</tt> command. Finally, disable the calibration function to avoid possible future disruptions due to misbehaving clocks or drivers. 
+<p>Some drivers depending on longwave and shortwave radio services
+need to know the radio propagation time from the transmitter to the
+receiver, which can amount to some tens of milliseconds. This must
+be calculated for each specific receiver location and requires the
+geographic coordinates of both the transmitter and receiver. The
+transmitter coordinates for various radio services are given in the
+<a href="qth.htm">Stations, Frequencies and Geographic
+Coordinates</a> page. Receiver coordinates can be obtained or
+estimated from various sources. The actual calculations are beyond
+the scope of this document.</p>
+
+<p>When more than one clock driver is supported, it is often the
+case that each shows small systematic offset differences relative
+to the rest. To reduce the effects of jitter when switching from
+one driver to the another, it is useful to calibrate the drivers to
+a common ensemble offset. The <tt>enable calibrate</tt>
+configuration command in the <a href="miscopt.htm">Miscellaneous
+Options</a> page is useful for this purpose. The calibration
+function can also be enabled and disabled using the <tt>ntpdc</tt>
+program utility.</p>
+
+<p>Most clock drivers use the <tt>time1</tt> value specified in the
+<tt>fudge</tt> configuration command to provide the calibration
+correction when this cannot be provided by the clock or interface.
+When the calibration function is enabled, the <tt>time1</tt> value
+is automatically adjusted to match the offset of the remote server
+or local clock driver selected for synchronization. Ordinarily, the
+NTP selection algorithm chooses the best from among all sources,
+usually the best radio clock determined on the basis of stratum,
+synchronization distance and jitter. The calibration function
+adjusts the <tt>time1</tt> values for all clock drivers except this
+source so that their indicated offsets tend to zero. If the
+selected source is the kernel PPS discipline, the <tt>fudge
+time1</tt> values for all clock drivers are adjusted.</p>
+
+<p>The adjustment function is an exponential average designed to
+improve accuracy, so the function takes some time to converge. The
+recommended procedure is to enable the function, let it run for an
+hour or so, then edit the configuration file using the <tt>
+time1</tt> values displayed by the <tt>ntpq</tt> utility and <tt>
+clockvar</tt> command. Finally, disable the calibration function to
+avoid possible future disruptions due to misbehaving clocks or
+drivers.</p>
 
 <h4>Performance Enhancements</h4>
 
-<p>In general, performance can be improved, especially when more than one clock driver is supported, to use the prefer peer function described in the <a href=prefer.htm>Mitigation Rules and the <tt>prefer</tt> Keyword</a> page. The prefer peer is ordinarily designated the remote peer or local clock driver which provides the best quality time. All other things equal, only the prefer peer source is used to discipline the system clock and jitter-producing "clockhopping" between sources is avoided. This is valuable when more than one clock driver is present and especially valuable when the PPS clock driver (type 22) is used. Support for PPS signals is summarized in the <a href=pps.htm>Pulse-per-second (PPS) Signal Interfacing</a> page.
-
-<p>Where the highest performance is required, generally better than one millisecond, additional hardware and/or software functions may be required. Kernel modifications for precision time are described in the <a href=kern.htm>A Kernel Model for Precision Timekeeping</a> page. Special line discipline and streams modules for use in capturing precision timestamps are described in the <a href=ldisc.htm>Line Disciplines and Streams Drivers</a> page.
+<p>In general, performance can be improved, especially when more
+than one clock driver is supported, to use the prefer peer function
+described in the <a href="prefer.htm">Mitigation Rules and the <tt>
+prefer</tt> Keyword</a> page. The prefer peer is ordinarily
+designated the remote peer or local clock driver which provides the
+best quality time. All other things equal, only the prefer peer
+source is used to discipline the system clock and jitter-producing
+"clockhopping" between sources is avoided. This is valuable when
+more than one clock driver is present and especially valuable when
+the PPS clock driver (type 22) is used. Support for PPS signals is
+summarized in the <a href="pps.htm">Pulse-per-second (PPS) Signal
+Interfacing</a> page.</p>
+
+<p>Where the highest performance is required, generally better than
+one millisecond, additional hardware and/or software functions may
+be required. Kernel modifications for precision time are described
+in the <a href="kern.htm">A Kernel Model for Precision
+Timekeeping</a> page. Special line discipline and streams modules
+for use in capturing precision timestamps are described in the <a
+href="ldisc.htm">Line Disciplines and Streams Drivers</a> page.</p>
 
 <h4>Comprehensive List of Clock Drivers</h4>
 
-<p>Following is a list showing the type and title of each driver currently implemented. The compile-time identifier for each is shown in parentheses. Click on a selected type for specific description and
-configuration documentation, including the clock address, reference ID, driver ID, device name and serial line speed, and features (line disciplines, etc.). For those drivers without specific documentation, please contact the author listed in the <a href=copyright.htm>Copyright Notice</a> page.
-
-<p><a href=driver1.htm>Type 1</a> Undisciplined Local Clock (<tt>LOCAL</tt>)
-<br><a href=driver2.htm>Type 2</a> Trak 8820 GPS Receiver (<tt>GPS_TRAK</tt>)
-<br><a href=driver3.htm>Type 3</a> PSTI/Traconex 1020 WWV/WWVH Receiver (<tt>WWV_PST</tt>)
-<br><a href=driver4.htm>Type 4</a> Spectracom WWVB and GPS Receivers (<tt>WWVB_SPEC</tt>)
-<br><a href=driver5.htm>Type 5</a> TrueTime GPS/GOES/OMEGA Receivers (<tt>TRUETIME</tt>)
-<br><a href=driver6.htm>Type 6</a> IRIG Audio Decoder (<tt>IRIG_AUDIO</tt>)
-<br><a href=driver7.htm>Type 7</a> Radio CHU Audio Demodulator/Decoder (<tt>CHU</tt>)
-<br><a href=driver8.htm>Type 8</a> Generic Reference Driver (<tt>PARSE</tt>)
-<br><a href=driver9.htm>Type 9</a> Magnavox MX4200 GPS Receiver (<tt>GPS_MX4200</tt>)
-<br><a href=driver10.htm>Type 10</a> Austron 2200A/2201A GPS Receivers (<tt>GPS_AS2201</tt>)
-<br><a href=driver11.htm>Type 11</a> Arbiter 1088A/B GPS Receiver (<tt>GPS_ARBITER</tt>)
-<br><a href=driver12.htm>Type 12</a> KSI/Odetics TPRO/S IRIG Interface (<tt>IRIG_TPRO</tt>)
-<br>Type 13 Leitch CSD 5300 Master Clock Controller (<tt>ATOM_LEITCH</tt>)
-<br>Type 14 EES M201 MSF Receiver (<tt>MSF_EES</tt>)
-<br><a href=driver5.htm>Type 15</a> * TrueTime generic receivers
-<br>Type 16 Bancomm GPS/IRIG Receiver (<tt>GPS_BANCOMM</tt>)
-<br>Type 17 Datum Precision Time System (<tt>GPS_DATUM</tt>)
-<br><a href=driver18.htm>Type 18</a> NIST Modem Time Service (<tt>ACTS_NIST</tt>)
-<br><a href=driver19.htm>Type 19</a> Heath WWV/WWVH Receiver (<tt>WWV_HEATH</tt>)
-<br><a href=driver20.htm>Type 20</a> Generic NMEA GPS Receiver (<tt>NMEA</tt>)
-<br>Type 21 TrueTime GPS-VME Interface (<tt>GPS_VME</tt>)
-<br><a href=driver22.htm>Type 22</a> PPS Clock Discipline (<tt>PPS</tt>)
-<br><a href=driver23.htm>Type 23</a> PTB Modem Time Service (<tt>ACTS_PTB</tt>)
-<br><a href=driver24.htm>Type 24</a> USNO Modem Time Service (<tt>ACTS_USNO</tt>)
-<br><a href=driver5.htm>Type 25</a> * TrueTime generic receivers
-<br><a href=driver26.htm>Type 26</a> Hewlett Packard 58503A GPS Receiver (<tt>GPS_HP</tt>)
-<br><a href=driver27.htm>Type 27</a> Arcron MSF Receiver (<tt>MSF_ARCRON</tt>)
-<br><a href=driver28.htm>Type 28</a> Shared Memory Driver (<tt>SHM</tt>)
-<br><a href=driver29.htm>Type 29</a> Trimble Navigation Palisade GPS (<tt>GPS_PALISADE</tt>)
-<br><a href=driver30.htm>Type 30</a> Motorola UT Oncore GPS (<tt>GPS_ONCORE</tt>)
-<br>Type 31 Rockwell Jupiter GPS (<tt>GPS_JUPITER</tt>)
-<br><a href=driver34.htm>Type 34</a> Ultralink WWVB Receivers
-<br><a href=driver35.htm>Type 35</a> Conrad Parallel Port Radio Clock (<tt>PCF</tt>)
-<br><a href=driver36.htm>Type 36</a> Radio WWV/H Audio Demodulator/Decoder(<tt>WWV</tt>)
-<br><a href=driver37.htm>Type 37</a> Forum Graphic GPS Dating station (<tt>FG</tt>)
-<br><a href=driver38.htm>Type 38</a> hopf GPS/DCF77 6021/komp for Serial Line (<tt>HOPF_S</tt>)
-<br><a href=driver39.htm>Type 39</a> hopf GPS/DCF77 6039 for PCI-Bus (<tt>HOPF_P</tt>)
-
-<p>* All TrueTime receivers are now supported by one driver, type 5.
-Types 15 and 25 will be retained only for a limited time and may be
-reassigned in future.
-
-<p>Additional Information
-
-<p><a href=prefer.htm>Mitigation Rules and the <tt>prefer</tt>
-Keyword</a>
-<br><a href=rdebug.htm>Debugging Hints for Reference Clock Drivers</a>
-<br><a href=kern.htm>A Kernel Model for Precision Timekeeping</a>
-<br><a href=ldisc.htm>Line Disciplines and Streams Drivers</a>
-<br><a href=audio.htm>Reference Clock Audio Drivers</a>
-<br><a href=pps.htm>Pulse-per-second (PPS) Signal Interfacing</a>
-<br><a href=howto.htm>How To Write a Reference Clock Driver</a>
-
-<hr><a href=index.htm><img align=left src=pic/home.gif></a><address><a
-href=mailto:mills@udel.edu> David L. Mills &lt;mills@udel.edu&gt;</a>
-</address></a></body></html>
+<p>Following is a list showing the type and title of each driver
+currently implemented. The compile-time identifier for each is
+shown in parentheses. Click on a selected type for specific
+description and configuration documentation, including the clock
+address, reference ID, driver ID, device name and serial line
+speed, and features (line disciplines, etc.). For those drivers
+without specific documentation, please contact the author listed in
+the <a href="copyright.htm">Copyright Notice</a> page.</p>
+
+<p><a href="driver1.htm">Type 1</a> Undisciplined Local Clock
+(<tt>LOCAL</tt>)<br>
+<a href="driver2.htm">Type 2</a> Trak 8820 GPS Receiver
+(<tt>GPS_TRAK</tt>)<br>
+<a href="driver3.htm">Type 3</a> PSTI/Traconex 1020 WWV/WWVH
+Receiver (<tt>WWV_PST</tt>)<br>
+<a href="driver4.htm">Type 4</a> Spectracom WWVB and GPS Receivers
+(<tt>WWVB_SPEC</tt>)<br>
+<a href="driver5.htm">Type 5</a> TrueTime GPS/GOES/OMEGA Receivers
+(<tt>TRUETIME</tt>)<br>
+<a href="driver6.htm">Type 6</a> IRIG Audio Decoder
+(<tt>IRIG_AUDIO</tt>)<br>
+<a href="driver7.htm">Type 7</a> Radio CHU Audio
+Demodulator/Decoder (<tt>CHU</tt>)<br>
+<a href="driver8.htm">Type 8</a> Generic Reference Driver
+(<tt>PARSE</tt>)<br>
+<a href="driver9.htm">Type 9</a> Magnavox MX4200 GPS Receiver
+(<tt>GPS_MX4200</tt>)<br>
+<a href="driver10.htm">Type 10</a> Austron 2200A/2201A GPS
+Receivers (<tt>GPS_AS2201</tt>)<br>
+<a href="driver11.htm">Type 11</a> Arbiter 1088A/B GPS Receiver
+(<tt>GPS_ARBITER</tt>)<br>
+<a href="driver12.htm">Type 12</a> KSI/Odetics TPRO/S IRIG
+Interface (<tt>IRIG_TPRO</tt>)<br>
+Type 13 Leitch CSD 5300 Master Clock Controller
+(<tt>ATOM_LEITCH</tt>)<br>
+Type 14 EES M201 MSF Receiver (<tt>MSF_EES</tt>)<br>
+<a href="driver5.htm">Type 15</a> * TrueTime generic receivers<br>
+Type 16 Bancomm GPS/IRIG Receiver (<tt>GPS_BANCOMM</tt>)<br>
+Type 17 Datum Precision Time System (<tt>GPS_DATUM</tt>)<br>
+<a href="driver18.htm">Type 18</a> NIST Modem Time Service
+(<tt>ACTS_NIST</tt>)<br>
+<a href="driver19.htm">Type 19</a> Heath WWV/WWVH Receiver
+(<tt>WWV_HEATH</tt>)<br>
+<a href="driver20.htm">Type 20</a> Generic NMEA GPS Receiver
+(<tt>NMEA</tt>)<br>
+Type 21 TrueTime GPS-VME Interface (<tt>GPS_VME</tt>)<br>
+<a href="driver22.htm">Type 22</a> PPS Clock Discipline
+(<tt>PPS</tt>)<br>
+<a href="driver23.htm">Type 23</a> PTB Modem Time Service
+(<tt>ACTS_PTB</tt>)<br>
+<a href="driver24.htm">Type 24</a> USNO Modem Time Service
+(<tt>ACTS_USNO</tt>)<br>
+<a href="driver5.htm">Type 25</a> * TrueTime generic receivers<br>
+<a href="driver26.htm">Type 26</a> Hewlett Packard 58503A GPS
+Receiver (<tt>GPS_HP</tt>)<br>
+<a href="driver27.htm">Type 27</a> Arcron MSF Receiver
+(<tt>MSF_ARCRON</tt>)<br>
+<a href="driver28.htm">Type 28</a> Shared Memory Driver
+(<tt>SHM</tt>)<br>
+<a href="driver29.htm">Type 29</a> Trimble Navigation Palisade GPS
+(<tt>GPS_PALISADE</tt>)<br>
+<a href="driver30.htm">Type 30</a> Motorola UT Oncore GPS
+(<tt>GPS_ONCORE</tt>)<br>
+Type 31 Rockwell Jupiter GPS (<tt>GPS_JUPITER</tt>)<br>
+<a href="driver34.htm">Type 34</a> Ultralink WWVB Receivers<br>
+<a href="driver35.htm">Type 35</a> Conrad Parallel Port Radio Clock
+(<tt>PCF</tt>)<br>
+<a href="driver36.htm">Type 36</a> Radio WWV/H Audio
+Demodulator/Decoder(<tt>WWV</tt>)<br>
+<a href="driver37.htm">Type 37</a> Forum Graphic GPS Dating station
+(<tt>FG</tt>)<br>
+<a href="driver38.htm">Type 38</a> hopf GPS/DCF77 6021/komp for
+Serial Line (<tt>HOPF_S</tt>)<br>
+<a href="driver39.htm">Type 39</a> hopf GPS/DCF77 6039 for PCI-Bus
+(<tt>HOPF_P</tt>)</p>
+
+<p>* All TrueTime receivers are now supported by one driver, type
+5. Types 15 and 25 will be retained only for a limited time and may
+be reassigned in future.</p>
+
+<p>Additional Information</p>
+
+<p><a href="prefer.htm">Mitigation Rules and the <tt>prefer</tt>
+Keyword</a><br>
+<a href="rdebug.htm">Debugging Hints for Reference Clock
+Drivers</a><br>
+<a href="kern.htm">A Kernel Model for Precision Timekeeping</a><br>
+<a href="ldisc.htm">Line Disciplines and Streams Drivers</a><br>
+<a href="audio.htm">Reference Clock Audio Drivers</a><br>
+<a href="pps.htm">Pulse-per-second (PPS) Signal Interfacing</a><br>
+<a href="howto.htm">How To Write a Reference Clock Driver</a></p>
+
+<hr>
+<a href="index.htm"><img align="left" src="pic/home.gif" alt=
+"gif"></a> 
+
+<address><a href="mailto:mills@udel.edu">David L. Mills
+&lt;mills@udel.edu&gt;</a></address>
+</body>
+</html>
+
index fd7e03ed352a4274f8b94bfea58e5971b3b91696..4b937abcbd356fd90e01504bf078019bac455c6d 100644 (file)
@@ -137,7 +137,7 @@ been extended to all drivers as an intrinsic function. Most of the
 drivers in NTPv3 have been converted to this interface, but some,
 including the PARSE subinterface, have yet to be overhauled. New
 drivers have been added for several GPS receivers now on the market
-for a total of 37 drivers. Drivers for the Canadian standard time
+for a total of 39 drivers. Drivers for the Canadian standard time
 and frequency station CHU, the US standard time and frequency
 stations WWV/H and for IRIG signals have been updated and
 capabilities added to allow direct connection of these signals to
@@ -203,7 +203,9 @@ Options</a> page for details.</p>
 <p>The <tt>ppsclock</tt> line discipline/streams module is no
 longer supported. This function is now handled by the <a href=
 "driver22.htm">PPS Clock Discipline</a> driver, which uses the new
-PPSAPI application program interface proposed by the IETF.</p>
+PPSAPI application program interface proposed by the IETF. Note
+that the <tt>pps</tt> configuration file command has been obsoleted by  the driver. See the <a href="pps.htm">Pulse-per-second (PPS) Signal
+Interfacing</a> page for further information.</p>
 </li>
 
 <li>
@@ -212,7 +214,8 @@ command line. For the inveterate knob twiddlers several of the more
 important performance variables can be changed to fit actual or
 perceived special conditions. It is possible to operate the daemon
 in a one-time mode similar to <tt>ntpdate</tt>, which program is
-headed for retirement. See the documentation page for the new
+headed for retirement. See the <a href="ntpd.htm"><tt>ntpd</tt> -
+Network Time Protocol (NTP) daemon</a> page for the new
 features.</p>
 </li>
 </ol>