The xntp3 Distribution Base Directory

This directory and its subdirectories contain the Network Time Protocol
Version 3 (NTP) distribution for Unix systems. The contents of the base
directory are given in this file. The contents of subdirectories are
given in the README files in each subdirectory.

A complete explanation of the configure, compile and install process, as
well as setting up an NTP subnet, is in the HTML pages in the ./html
directory. For more information on NTP and how to get a working setup,
read WHERE-TO-START.

Note that the ./doc, ./hints and ./gadget directories in previous
releases prior to xntp3.5 are gone. The ./doc and ./hints directories
have been replaced with the ./html directory, which contains a complete
set of documentation in HTML format. In addition, the information in the
PORTING and RELNOTES has been incorporated in the HTML documentation.
The ./gadget directory has been replaced by a compressed tar archive
available via the documentation pages.

Note that in this release the ./compilers, ./machines and ./refclocks
directories and Config.local.dist file in previous releases are gone.
They have been replaced by files used by the new autoconfigure feature,
which uses the GNU automake-1.2 and autoconf-2.12 utilities. These
utilities are used only to construct the distribution itself and are not
neccesary to compile and install the software.

The base directory ./ contains the autoconfiguation files, source
directories and related stuff:

COPYRIGHT	link to the HTML file ./html/copyright.html. This file
		specifies copyright conditions, together with a list of
		major authors and electric addresses.

INSTALL		hints for compiling and installing the software. Unless
		you really know what you are doing, you should read the
		directions in the HTML pages.

Makefile.am	make file configuration file. Edit only if you have the
		GNU automake and autoconf utilities installed.

Makefile.in	make file template for Unix. Do not edit.

NEWS		What's new in this release.

README		this file.

TAGS            used by Unix utilities.

TODO            used by system developers.

WHERE-TO-START	hints on what to read in order to get a working
		configuration.

acconfig.h	configuration template header file. Edit only if you
		have the GNU automake and autoconf utilities installed.

adjtimed        directory containing the sources for the adjtime daemon
		for HP/UX systems prior to HP-UX 10.0.

autoconf-2.12.patches	  Patches for GNU autoconf-2.12

automake-1.2.patches	  Patches for GNU automake-1.2 (not really needed)

authstuff       directory containing sources for miscellaneous programs
		to test, calibrate and certify the cryptographic
		mechanisms for DES and MD5 based authentication. These
		programs do not include the cryptographic routines
		themselves, so are free of U.S. export restrictions.

clockstuff	directory containing sources for miscellaneous programs
		to test certain auxiliary programs used with some kernel
		configurations, together with a program to calculate
		propagation delays for use with radio clocks and
		national time dissemination services such as WWV/WWVH,
		WWVB and CHU.

conf            directory containing a motley collection of
		configuration files for various systems. For example only. 

config.guess	script used to identify the machine architecture and
		operating system.

config.h.in	configuration file generated automatically from
		configure.in. Do not edit.

configure	script used to configure the distribution. See the HTML
		pages for a complete description of the options available.

configure.in	master configuration template. Edit only if you have the
		GNU automake and autoconf utilities installed.

html            directory containing a complete set of documentation on
		building and configuring a NTP server or client. The
		documentation is in the form of HTML files suitable for
		browsing and contains links to additional documentation
		at various web sites. If a browser is unavailable, an
		ordinary text editor can be used.

include		directory containing include header files used by most
		programs in the distribution.

install-sh	script to install a program, script or data file.

kernel		directory containing sources for kernel programs such as
		line disciplines and STREAMS modules used with the CHU
		decoder and precision PPS signals.

lib             directory containing library source code used by most
		programs in the distribution.

libntp		directory containing library source code used by most
		programs in the distribution.

ntpdate		directory containing sources for a program to set the
		local machine time from one or more remote machines
		running NTP.  Operates like rdate, but much more accurate.

ntpq            directory containing sources for a utility program to
		query local and remote NTP peers for state variables and
		related timekeeping information. This program conforms
		to Appendix A of the NTP Version 3 Specification RFC 1305.

ntptrace        directory containing sources for a utility program that
		can be used to reveal the chain of NTP peers from a
		designated peer to the primary server at the root of the
		timekeeping subnet.

parse		directory containing files belonging to the generic
		parse reference clock driver. For reasonably simple
		clocks it is possible to get away with about 3-4Kb of
		code. additionally the SunOS 4.x/Solaris 5.3 streams
		module for parse squats here.

patches		directory containing patches already applied to this
		distribution. These are included for record and to help
		in possible porting problems.

scripts		directory containing scripts to build the configuration
		files in this directory and then the makefiles used in
		various dependent directories. the subdirectories
		monitoring and support hold various perl and shell
		scripts for visualizing synchronization and daemon startup.

stamp.h.in	configuration file generated automatically from configure.in.
		Do not edit.

util            directory containing sources for various utility and
		testing programs.

xntpd		directory containing sources for the NTP Version 3 daemon.

xntpdc		directory containing sources for a utility program to
		query local and remote NTP peers for state variables and
		related timekeeping information. This program is
		specific to this implementation of NTP Version 3 and
		does not conform to Appendix A of the NTP Version 3
		Specification RFC 1305.

David L. Mills (mills@udel.edu)
12 June 1996
