144 lines
5.1 KiB
Text
144 lines
5.1 KiB
Text
This is the README for chrony.
|
|
|
|
What is chrony?
|
|
===============
|
|
|
|
chrony is a versatile implementation of the Network Time Protocol (NTP).
|
|
It can synchronise the system clock with NTP servers, reference clocks
|
|
(e.g. GPS receiver), and manual input using wristwatch and keyboard.
|
|
It can also operate as an NTPv4 (RFC 5905) server and peer to provide
|
|
a time service to other computers in the network.
|
|
|
|
It is designed to perform well in a wide range of conditions, including
|
|
intermittent network connections, heavily congested networks, changing
|
|
temperatures (ordinary computer clocks are sensitive to temperature),
|
|
and systems that do not run continuously, or run on a virtual machine.
|
|
|
|
Typical accuracy between two machines synchronised over the Internet is
|
|
within a few milliseconds; on a LAN, accuracy is typically in tens of
|
|
microseconds. With hardware timestamping, or a hardware reference clock,
|
|
sub-microsecond accuracy may be possible.
|
|
|
|
Two programs are included in chrony, chronyd is a daemon that can be
|
|
started at boot time and chronyc is a command-line interface program
|
|
which can be used to monitor chronyd's performance and to change various
|
|
operating parameters whilst it is running.
|
|
|
|
What will chrony run on?
|
|
========================
|
|
|
|
The software is known to work on Linux, FreeBSD, NetBSD, macOS and
|
|
illumos. Closely related systems may work too. Any other system will
|
|
likely require a porting exercise.
|
|
|
|
How do I set it up?
|
|
===================
|
|
|
|
The file INSTALL gives instructions. On supported systems the
|
|
compilation process should be automatic. You will need a C compiler,
|
|
e.g. gcc or clang.
|
|
|
|
What documentation is there?
|
|
============================
|
|
|
|
The distribution includes manual pages and a document containing
|
|
Frequently Asked Questions (FAQ).
|
|
|
|
The documentation is also available on the chrony web pages, accessible
|
|
through the URL
|
|
|
|
https://chrony-project.org/
|
|
|
|
License
|
|
=======
|
|
|
|
chrony is distributed under the GNU General Public License version 2.
|
|
|
|
Authors
|
|
=======
|
|
|
|
Richard P. Curnow <rc@rc0.org.uk>
|
|
Miroslav Lichvar <mlichvar@redhat.com>
|
|
|
|
Acknowledgements
|
|
================
|
|
|
|
In writing the chronyd program, extensive use has been made of the NTPv3 (RFC
|
|
1305) and NTPv4 (RFC 5905) specification. The source code of the xntpd/ntpd
|
|
implementation written by Dennis Fergusson, Lars Mathiesen, David Mills, and
|
|
others has been used to check the details of the protocol.
|
|
|
|
The following people have provided patches and other major contributions
|
|
to chrony:
|
|
|
|
Lonnie Abelbeck <lonnie@abelbeck.com>
|
|
Benny Lyne Amorsen <benny@amorsen.dk>
|
|
Andrew Bishop <amb@gedanken.demon.co.uk>
|
|
Vincent Blut <vincent.debian@free.fr>
|
|
Stephan I. Boettcher <stephan@nevis1.columbia.edu>
|
|
David Bohman <debohman@gmail.com>
|
|
Goswin Brederlow <brederlo@informatik.uni-tuebingen.de>
|
|
Leigh Brown <leigh@solinno.co.uk>
|
|
Erik Bryer <ebryer@spots.ab.ca>
|
|
Jonathan Cameron <jic23@cam.ac.uk>
|
|
Bryan Christianson <bryan@whatroute.net>
|
|
Juliusz Chroboczek <jch@pps.jussieu.fr>
|
|
Dan Drown <dan-ntp@drown.org>
|
|
Kamil Dudka <kdudka@redhat.com>
|
|
Christian Ehrhardt <christian.ehrhardt@canonical.com>
|
|
Paul Elliott <pelliott@io.com>
|
|
Robert Fairley <rfairley@redhat.com>
|
|
Stefan R. Filipek <srfilipek@gmail.com>
|
|
Andy Fiddaman <illumos@fiddaman.net>
|
|
Mike Fleetwood <mike@rockover.demon.co.uk>
|
|
Rob Gill <rrobgill@protonmail.com>
|
|
Alexander Gretencord <arutha@gmx.de>
|
|
Andrew Griffiths <agriffit@redhat.com>
|
|
Walter Haidinger <walter.haidinger@gmx.at>
|
|
Juergen Hannken-Illjes <hannken@eis.cs.tu-bs.de>
|
|
John Hasler <john@dhh.gt.org>
|
|
Tjalling Hattink <t.hattink@fugro.nl>
|
|
Liam Hatton <me@liamhatton.com>
|
|
Holger Hoffstätte <holger@applied-asynchrony.com>
|
|
Jachym Holecek <jakym@volny.cz>
|
|
Håkan Johansson <f96hajo@chalmers.se>
|
|
Jim Knoble <jmknoble@pobox.com>
|
|
Antti Jrvinen <costello@iki.fi>
|
|
Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
|
|
Eric Lammerts <eric@lammerts.org>
|
|
Stefan Lucke <stefan@lucke.in-berlin.de>
|
|
Victor Lum <viclum@vanu.com>
|
|
Kevin Lyda <kevin@ie.suberic.net>
|
|
Paul Menzel <paulepanter@users.sourceforge.net>
|
|
Vladimir Michl <vladimir.michl@seznam.cz>
|
|
Victor Moroz <vim@prv.adlum.ru>
|
|
Kalle Olavi Niemitalo <tosi@stekt.oulu.fi>
|
|
Patrick Oppenlander <patrick.oppenlander@gmail.com>
|
|
Frank Otto <sandwichmacher@web.de>
|
|
Denny Page <dennypage@me.com>
|
|
Rupesh Patel <rupatel@redhat.com>
|
|
Chris Perl <cperl@janestreet.com>
|
|
Gautier PHILIPPON <gautier.philippon@ensimag.grenoble-inp.fr>
|
|
Andreas Piesk <apiesk@virbus.de>
|
|
Mike Ryan <msr@hsilop.net>
|
|
Baruch Siach <baruch@tkos.co.il>
|
|
Josef 'Jeff' Sipek <jeffpc@josefsipek.net>
|
|
Foster Snowhill <forst@forstwoof.ru>
|
|
Andreas Steinmetz <ast@domdv.de>
|
|
NAKAMURA Takumi <takumi@ps.sakura.ne.jp>
|
|
Timo Teras <timo.teras@iki.fi>
|
|
Bill Unruh <unruh@physics.ubc.ca>
|
|
Luke Valenta <lvalenta@cloudflare.com>
|
|
Stephen Wadeley <swadeley@redhat.com>
|
|
Bernhard Weiss <lisnablagh@web.de>
|
|
Wolfgang Weisselberg <weissel@netcologne.de>
|
|
Bernhard M. Wiedemann <bwiedemann@suse.de>
|
|
Joachim Wiedorn <ad_debian@joonet.de>
|
|
Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
|
|
Ulrich Windl <ulrich.windl@rz.uni-regensburg.de>
|
|
Michael Witten <mfwitten@gmail.com>
|
|
Doug Woodward <dougw@whistler.com>
|
|
Thomas Zajic <zlatko@zlatko.fdns.net>
|
|
|
|
Many other people have contributed bug reports and suggestions. We are sorry
|
|
we cannot identify all of you individually.
|