This file contains instructions to compile and install the programs in
this distribution. To make these programs:

(1) Edit Config.local and choose the compilation options, install
    destination directory and clock drivers, if needed.

(2) Type "make makefiles".  This runs a shell script that pokes your
    hardware and software configuration and builds the configuration
    file and Makefiles in the various directories.  If the script fails,
    it will give you a list of machines it knows about.  You can override
    the automatic choice by cd to the ../machines directory and typing
    "make makefiles OS=<machine>", where <machine> is one of the file
    names in the ../machine directory.

    The shell script will attempt to find the gcc compiler and, if
    found, will use it instead of the cc compiler.  You can override
    this automatic choice by cd to the ../machines directory and typing
    "make makefiles CC=<compiler>", where <compiler> is one of the file
    names in the ../compilers directory. This can be combined with
    the OS argument above.

(3) Type "make" to compile everything of general interest. Expect few or
    no warnings using cc and a moderate level on warnings using gcc.

(4) Assuming you have write permission on the install destination directory,
    type "make install" to put the binaries in the system directory
    you mentioned in Config.local.  At the time of writing this includes
    the programs xntpd (the daemon), xntpdc (an xntpd-dependent query
    program), ntpq (a standard query program), ntpdate (an rdate
    replacement for boot time date setting and sloppy time keeping)
    and xntpres (a program which provides name resolver support for
    some xntpd configurations).

(5) You are now ready to configure the daemon and start it.  At this
    point it might be useful to format and print the file doc/notes.me
    and read a little bit.  The sections on configuration and on the
    tickadj program will be immediately useful.

Additional "make" target you might find useful are:

clean		cleans out object files, programs and temporary files

distclean	does the work of clean, then ambushes old patch
		files, tar files and Makefiles

depend		possible maker of hazardous waste

All bug reports gratefully received.

The distribution has been compiled and run on at least the following
machines, operating systems and compilers. In all known cases, if
the gcc compiler eats it with some success, the cc compiler also enjoys
the meal. The converse is not always true.

	VAX-11/785 4.3 tahoe	cc	no REFCLOCK
	Sun3	SunOS4.1.1	gcc	no REFCLOCK
	Sun4	SunOS4.1.1	gcc	all REFCLOCK drivers
	Sun4	SunOS4.1.3	gcc	MSF clock
	Sun4	SunOS5.1	gcc	no REFCLOCK
	Sun4	SunOS5.2	gcc	no REFCLOCK
	HP700	HPUX9.0		cc	no REFCLOCK
	HP300	HPUX8.0		cc	no REFCLOCK
	MIPS	Ultrix4.3a	gcc	WWVB clock
	ALPHA	OSF 1.2a	gcc	no REFCLOCK
	Convex	ConvexOS 10.1	?	?
	SGI	IRIX4		?	?
	AIX	3.2		?	?
	A/UX	2.0.1, 3.0.x	?	?

William L. Jones jones@chpc.utexas.edu
Dennis Ferguson (Advanced Network Systems) dennis@ans.net
Lars Mathiesen (University of Copenhagen) <thorinn@diku.dk>
David Mills <mills@udel.edu>
-- and a cast of thousands
8 September 1993

