8884034104
This is a verbatim copy of the files at that stage of the repository that was built from the CVS import. It allows future development to see a bit of recent history, but without carrying around the baggage going back to 1997. If that is really required, git grafts can be used.
89 lines
3 KiB
Text
89 lines
3 KiB
Text
The software is distributed as source code which has to be compiled.
|
|
|
|
PARTS OF THE SOFTWARE ARE HIGHLY SYSTEM-SPECIFIC AND NON-PORTABLE.
|
|
UNLESS YOU ARE RUNNING A SUPPORTED SYSTEM, BE PREPARED FOR SOME
|
|
PROGRAMMING!
|
|
|
|
After unpacking the source code, change directory into it, and type
|
|
|
|
./configure
|
|
|
|
This is a shell script that automatically determines the system type.
|
|
There is a single optional parameter, --prefix which indicates the
|
|
directory tree where the software should be installed. For example,
|
|
|
|
./configure --prefix=/opt/free
|
|
|
|
will install the chronyd daemon into /opt/free/sbin and the chronyc
|
|
control program into /opt/free/bin. The default value for the prefix
|
|
is /usr/local.
|
|
|
|
The configure script assumes you want to use gcc as your compiler.
|
|
If you want to use a different compiler, you can configure this way:
|
|
|
|
CC=cc CFLAGS=-O ./configure --prefix=/opt/free
|
|
|
|
for Bourne-family shells, or
|
|
|
|
setenv CC cc
|
|
setenv CFLAGS -O
|
|
./configure --prefix=/opt/free
|
|
|
|
for C-family shells.
|
|
|
|
If the software cannot (yet) be built on your system, an error message
|
|
will be shown. Otherwise, the files `options.h' and `Makefile' will
|
|
be generated.
|
|
|
|
By default, chronyc will be built to make use of the readline library. If you
|
|
don't want this, specify the --disable-readline flag to configure. If you have
|
|
readline and/or ncurses installed in a non-standard location, please refer to
|
|
the chrony.txt file for information.
|
|
|
|
Now type
|
|
|
|
make
|
|
|
|
to build the programs.
|
|
|
|
If you want to build the manual in plain text, HTML and info versions, type
|
|
|
|
make docs
|
|
|
|
Once the programs have been successfully compiled, they need to be
|
|
installed in their target locations. This step normally needs to be
|
|
performed by the superuser, and requires the following command to be
|
|
entered.
|
|
|
|
make install
|
|
|
|
This will install the binaries, plain text manual and manpages.
|
|
|
|
To install the HTML and info versions of the manual as well, enter the command
|
|
|
|
make install-docs
|
|
|
|
If you want chrony to appear in the top level info directory listing, you need
|
|
to run the install-info command manually after this step. install-info takes 2
|
|
arguments. The first is the path to the chrony.info file you have just
|
|
installed. This will be the argument you gave to --prefix when you configured
|
|
(/usr/local by default), with /info/chrony.info on the end. The second
|
|
argument is the location of the file called 'dir'. This will typically be
|
|
/usr/info/dir. So the typical command line would be
|
|
|
|
install-info /usr/local/info/chrony.info /usr/info/dir
|
|
|
|
Now that the software is successfully installed, the next step is to
|
|
set up a configuration file. The contents of this depend on the
|
|
network environment in which the computer operates. Typical scenarios
|
|
are described in the manual. The simplest case is for a computer with
|
|
a permanent Internet connection - suppose you want to use the NTP
|
|
server ntp1.foobar.com as your time reference. You would create an
|
|
/etc/chrony.conf file containing
|
|
|
|
server ntp1.foobar.com
|
|
driftfile /etc/chrony.drift
|
|
|
|
and then run /usr/local/sbin/chronyd.
|
|
|
|
|