contrib/ntp/util/README

   1 README file for directory ./util of the NTP Version 4 distribution
   2
   3 This directory contains the sources for the various utility programs.
   4 See the README and RELNOTES files in the parent directory for directions
   5 on how to make and install these programs.
   6
   7 The ntptime.c program checks the kernel configuration for the NTP user
   8 interface syscalls ntp_gettime() and ntp_adjtime().  If present, the
   9 current timekeeping data are displayed.  If not, a dissapointment is
  10 displayed.  See the kernel page file in the HTML documentation in
  11 distribution for further details. ntptime will be built be if configure
  12 believes your system can use it.
  13
  14 The jitter.c program can be used to determine the timing jitter due to
  15 the operating system in a gettimeofday() call.  For most systems the
  16 dominant contribution to the jitter budget is the period of the hardware
  17 interrupt, usually in the range 10 us-1 ms.  For those systems with
  18 microsecond counters, such as recent Sun and certain HP and DEC systems,
  19 the jitter is dominated only by the operating system.
  20
  21 The timetrim.c program can be used with SGI machines to implement a
  22 scheme to discipline the hardware clock frequency.  See the source code
  23 for further information.
  24
  25 The byteorder.c and longsize.c programs are used during the configuration
  26 process to determine the byte order (little or big endian) and longword
  27 size (32 or 64 bits).  See the configure scripts for further details.
  28
  29 The testrs6000.c program is used for testing purposes with the IBM
  30 RS/6000 AIX machines. Bill Jones <jones@chpc.utexas.edu> reports:
  31 "I could not get a tickadj of less then 40 us to work on a RS6000.
  32 If you set it less then 40 us do so at your own risk!"
  33
  34 The tickadj.c program can be used to read and set various kernel
  35 parameters affecting NTP operations. See the tickadj page in the HTML
  36 documentation for further details.  tickadj will be built if configure
  37 believes your system can use it.