doc: update chrony.conf man page

This commit is contained in:
Miroslav Lichvar 2015-01-23 11:21:12 +01:00
parent 72f0f99ac3
commit 04f86aa2ff

View file

@ -12,30 +12,44 @@ boot time.
Assuming that you have found some servers, you need to set up a Assuming that you have found some servers, you need to set up a
configuration file to run \fIchrony\fR. The (compiled-in) default location configuration file to run \fIchrony\fR. The (compiled-in) default location
for this file is \fB@SYSCONFDIR@/chrony.conf\fR. Assuming that your ntp servers for this file is \fB@SYSCONFDIR@/chrony.conf\fR. Assuming that your NTP
are called `a.b.c' and `d.e.f', your \fBchrony.conf\fR file could contain servers are called `foo.example.net', `bar.example.net' and `baz.example.net',
as a minimum your \fBchrony.conf\fR file could contain as a minimum
server a.b.c .EX
server d.e.f server foo.example.net
server g.h.i server bar.example.net
server baz.example.net
.EE
However, you will probably want to include some of the other directives However, you will probably want to include some of the other directives
described in detail in the documentation supplied with the distribution described in detail in the documentation supplied with the distribution
(\fIchrony.txt\fR and \fIchrony.texi\fR). The following directives may be (\fIchrony.txt\fR and \fIchrony.texi\fR). The following directives may be
particularly useful : `driftfile', `generatecommandkey', `keyfile', `makestep'. particularly useful : `driftfile', `makestep', `rtcsync'. Also, the `iburst'
Also, the `iburst' server option is useful to speed up the initial server option is useful to speed up the initial synchronization. The smallest
synchronization. The smallest useful configuration file would look something useful configuration file would look something like
like
server a.b.c iburst .EX
server d.e.f iburst server foo.example.net iburst
server g.h.i iburst server bar.example.net iburst
keyfile @SYSCONFDIR@/chrony.keys server baz.example.net iburst
generatecommandkey
driftfile @CHRONYVARDIR@/drift driftfile @CHRONYVARDIR@/drift
makestep 10 3 makestep 10 3
rtcsync
.EE
When using a pool of NTP servers (one name is used for multiple servers which
may change over time), it's better to specify them with the `pool' directive
instead of multiple `server' directives in order to allow \fIchronyd\fR to
replace unreachable or bad servers automatically. The configuration file could
in this case look like
.EX
pool pool.ntp.org iburst
driftfile @CHRONYVARDIR@/drift
makestep 10 3
rtcsync
.EE
.SH "SEE ALSO" .SH "SEE ALSO"
.BR chrony(1), .BR chrony(1),