Home | History | Annotate | Line # | Download | only in hints
      1 Notes for NTP Version 3
      2 
      3 This version operates in much the same manner as Version 2 with the
      4 following changes and additions:
      5 
      6 1.   The protocol machinery operates in conformance with the RFC1305 NTP
      7      Version 3 specification. The most visible characteristic of this
      8      version is that the poll intervals for all polls, even selected
      9      ones, is significantly increased. This is especially desirable when
     10      serving a large client population. This implementation supports
     11      previous versions as non-configured peers; for version-2 configured
     12      peers a "version 2" keyword should be included on the "peer" line.
     13 
     14 2.   The configuration file has a new keyword: statfile <file>, where
     15      <file> is the name of a statistics file." When present, each clock
     16      update generates an entry of the form:
     17 
     18      <day> <sec>.<frac> <addr> <status> <offset> <delay> <disp>
     19 
     20      where <day> is the modified Julian day, <sec>.<frac> is the time of
     21      day, <addr> is the peer address and <status> is the peer status.
     22      The <offset>, <delay> and <disp> are the measured offset, delay and
     23      dispersion, respectively, of the peer clock relative to the local
     24      clock. About once per day the current file is closed and a new one
     25      created with names <file>.<gen>, where <gen> starts at one and
     26      increments for each new generation.
     27 
     28 3.   A number of additional platforms are supported. See ./Config file
     29      for details.
     30 
     31 4.   A driver for the TrueTime 468DC GOES Synchronized Clock is
     32      included. This driver (refclock_goes.c) should also work for other
     33      TrueTime radio clocks, since all use the same format.
     34 
     35 5.   A replacement driver for the Spectracom 8170 WWVB Synchronized
     36      Clock is included. This driver (refclock_wwvb.c) (a) does not
     37      require a 1-pulse-per-second signal, (b) supports both format 0
     38      (original 8170) and format 2 (Netclock/2 and upgraded 8170), (c)
     39      can be connected to more than one computer and (d) automatically
     40      compensates for all serial baud rates.
     41 
     42 6.   A driver for the German time/frequency station DCF77 is included.
     43      This requires a special STREAMS module.
     44 
     45 7.   In Version 2 special line-discipline modules were required for the
     46      CHU and WWVB drivers. This code continues to work in Version 3,
     47      although it is no longer needed for the WWVB driver. However, this
     48      code does not work under STREAMS, as used in SunOS 4.1.1.
     49      Equivalent STREAMS modules are supplied with Version 3.
     50 
     51 8.   Support for an external 1-pulse-per-second (pps) signal is
     52      provided. The signal is connected to a serial port (see
     53      xntpd/ntp_loopfilter.c for details). When present the leading edge
     54      of the pulse establishes the on-time epoch within an interval
     55      established by the selected radio clock or other NTP time server.
     56      Use of the pps is indicated when the tattletale displayed by ntpq
     57      changes from "*" to "o".
     58 
     59 9.   The clock-selection and poll-update procedures have been modified
     60      slightly in order to achieve better performance on high speed LANs
     61      with compromise in performance on typical WANs.
     62 
     63 10.  In order to comply with U.S. Commerce Department regulations, the DES
     64      encryption routine lib/authdes.c cannot be exported. For exportable
     65      versions of this distribution a DES-encrypted version of this routine
     66      lib/authdes.c.des is included along with an unencrypted version
     67      lib/authdes.c.export, which allows normal operation, but without the
     68      NTP authentication feature. Further information is available in the
     69      lib/authdes.c.export file.
     70 
     71 11.  As an alternative to the DES-based authentication mechanism, an
     72      implementation of the RSA Message Digest 5 algorithm is provided.
     73      (see applicable copyright information in the library files).
     74 
     75 12.  A driver for the Magnavox MX4200 GPS clock.
     76 
     77 13.  A STREAMS module which captures carrier-detect data-lead transitions to
     78      connect a precision source of 1-pps, yet avoid the ugly overhead in the
     79      usual STREAMS processing. See the ppsclock subdirectory.
     80 
     81 14.  Support for the Apple A/UX operating system and enhanced support for the
     82      Hewlet-Packard HP/UX operating system. See the various README and Config
     83      files for further information. 
     84 
     85 See the COPYRIGHT file for authors and copyright information. Note that some
     86 modules in this distribution contain copyright information that supersedes
     87 the copyright information in that file.
     88 
     89 If I missed something or neglected to give due credit, please advise.
     90 
     91 David L. Mills
     92 University of Delaware
     93 31 May 1992, amended 23 July 1992, 25 October 1992
     94 
     95 Bugs and notes
     96 
     97 A bug in the original tty_clk_STREAMS.c module has been fixed.
     98 
     99 The poll-interval randomization feature of poll_update (in
    100 xntpd/ntp_proto.c) has been extended to apply when the poll interval is
    101 increased, as well as reduced. This spreads the update messages in time
    102 and helps avoid unpleasant bursts of messages.
    103 
    104 In the clock_select algorithm the peers selected for combining are
    105 limited to those survivors at the lowest stratum, not the entire list.
    106 This helps avoid whiplash when large numbers of peers are at the same
    107 stratum.
    108 
    109 The number formerly displayed by ntpq as "compliance" is now the time
    110 constant of integration.
    111 
    112 The DNS resolver xntpd/ntp_intres.c is now integrated into xntpd, making
    113 configuration of multiple hosts easier.
    114 
    115 System and peer event are now written to the system log at priority
    116 LOG_INFO.
    117 
    118 The leap-second code was fixed to avoid broadcasting leap warnings on
    119 all except the last day of June and December.
    120