72 lines
2.7 KiB
Groff
72 lines
2.7 KiB
Groff
.TH CHRONY 1 "@MAN_DATE@" "chrony @VERSION@" "User's Manual"
|
|
.SH NAME
|
|
chrony \- programs for keeping computer clocks accurate
|
|
|
|
.SH SYNOPSIS
|
|
\fBchronyc\fR [\fIOPTIONS\fR]
|
|
|
|
\fBchronyd\fR [\fIOPTIONS\fR]
|
|
|
|
.SH DESCRIPTION
|
|
\fBchrony\fR is a pair of programs for keeping computer clocks accurate.
|
|
\fIchronyd\fR is a background (daemon) program and \fIchronyc\fR is a
|
|
command-line interface to it. Time reference sources for chronyd can be
|
|
NTP servers, human (via keyboard and \fIchronyc\fR), or the computer's
|
|
real-time clock at boot time (Linux only). chronyd can determine the rate at
|
|
which the computer gains or loses time and compensate for it while no external
|
|
reference is present. Its use of NTP servers can be switched on and off
|
|
(through \fIchronyc\fR) to support computers with dial-up/intermittent access
|
|
to the Internet, and it can also act as an NTP server.
|
|
|
|
.SH USAGE
|
|
\fIchronyc\fR is a command-line interface program which can be used to
|
|
monitor \fIchronyd\fR's performance and to change various operating
|
|
parameters whilst it is running.
|
|
|
|
\fIchronyd\fR's main function is to obtain measurements of the true (UTC)
|
|
time from one of several sources, and correct the system clock
|
|
accordingly. It also works out the rate at which the system clock
|
|
gains or loses time and uses this information to keep it accurate
|
|
between measurements from the reference.
|
|
|
|
The reference time can be derived from either Network Time Protocol
|
|
(NTP) servers, reference clocks, or wristwatch-and-keyboard (via \fIchronyc\fR).
|
|
The main source of information about the Network Time Protocol is
|
|
\fIhttp://www.ntp.org\fR.
|
|
|
|
It is designed so that it can work on computers which only have
|
|
intermittent access to reference sources, for example computers which
|
|
use a dial-up account to access the Internet or laptops. Of course, it
|
|
will work well on computers with permanent connections too.
|
|
|
|
In addition, on Linux it can monitor the system's real time clock
|
|
performance, so the system can maintain accurate time even across
|
|
reboots.
|
|
|
|
Typical accuracies available between 2 machines are
|
|
|
|
On an ethernet LAN : 100-200 microseconds, often much better
|
|
On a V32bis dial-up modem connection : 10's of milliseconds (from one
|
|
session to the next)
|
|
|
|
With a good reference clock the accuracy can reach one microsecond.
|
|
|
|
\fIchronyd\fR can also operate as an NTPv4 (RFC 5905) server, peer and
|
|
broadcast server.
|
|
|
|
.SH "SEE ALSO"
|
|
.BR chronyc(1),
|
|
.BR chrony.conf(5),
|
|
.BR chronyd(8)
|
|
|
|
.I http://chrony.tuxfamily.org/
|
|
|
|
.SH AUTHOR
|
|
Richard Curnow <rc@rc0.org.uk>
|
|
|
|
This man-page was written by Jan Schaumann <jschauma@netmeister.org> as part
|
|
of "The Missing Man Pages Project". Please see
|
|
\fIhttp://www.netmeister.org/misc/m2p2/index.html\fR for details.
|
|
|
|
The complete chrony documentation is supplied in texinfo format.
|
|
|