56 lines
2.9 KiB
Diff
56 lines
2.9 KiB
Diff
commit b889627998ba584528d1c1145a212fb2b97e5289
|
|
Author: Miroslav Lichvar <mlichvar@redhat.com>
|
|
Date: Thu Feb 27 10:04:41 2025 +0100
|
|
|
|
doc: improve description of refresh directive
|
|
|
|
diff --git a/doc/chrony.conf.adoc b/doc/chrony.conf.adoc
|
|
index 7ccdd20c..eb00e029 100644
|
|
--- a/doc/chrony.conf.adoc
|
|
+++ b/doc/chrony.conf.adoc
|
|
@@ -941,14 +941,15 @@ time, assuming the first update corrects the clock and later checks can work
|
|
with correct time.
|
|
|
|
[[refresh]]*refresh* _interval_::
|
|
-This directive specifies the interval (in seconds) between refreshing IP
|
|
-addresses of NTP sources specified by hostname. If the hostname no longer
|
|
+This directive specifies the minimum interval (in seconds) between refreshing
|
|
+IP addresses of NTP sources specified by hostname. If the hostname no longer
|
|
resolves to the currently used address, it will be replaced with one of the new
|
|
addresses to avoid using a server which is no longer intended for service, even
|
|
if it is still responding correctly and would not be replaced as unreachable.
|
|
-Only one source is refreshed at a time. The default value is 1209600 (2 weeks)
|
|
-and the maximum value is 2^31-1 (68 years). A value of 0 disables the periodic
|
|
-refreshment.
|
|
+Only one source is refreshed at a time and only when a valid response is
|
|
+received (unreachable sources are replaced independently). The default value is
|
|
+1209600 (2 weeks) and the maximum value is 2^31-1 (68 years). A value of 0
|
|
+disables the periodic refreshment.
|
|
+
|
|
The <<chronyc.adoc#refresh,*refresh*>> command can be used to refresh all
|
|
sources immediately.
|
|
diff -up chrony-4.6.1/doc/chrony.conf.man.in.docrefresh chrony-4.6.1/doc/chrony.conf.man.in
|
|
--- chrony-4.6.1/doc/chrony.conf.man.in.docrefresh 2025-05-15 17:04:33.824077026 +0200
|
|
+++ chrony-4.6.1/doc/chrony.conf.man.in 2025-05-15 17:04:53.308070453 +0200
|
|
@@ -1270,14 +1270,15 @@ with correct time.
|
|
.sp
|
|
\fBrefresh\fP \fIinterval\fP
|
|
.RS 4
|
|
-This directive specifies the interval (in seconds) between refreshing IP
|
|
-addresses of NTP sources specified by hostname. If the hostname no longer
|
|
+This directive specifies the minimum interval (in seconds) between refreshing
|
|
+IP addresses of NTP sources specified by hostname. If the hostname no longer
|
|
resolves to the currently used address, it will be replaced with one of the new
|
|
addresses to avoid using a server which is no longer intended for service, even
|
|
if it is still responding correctly and would not be replaced as unreachable.
|
|
-Only one source is refreshed at a time. The default value is 1209600 (2 weeks)
|
|
-and the maximum value is 2^31\-1 (68 years). A value of 0 disables the periodic
|
|
-refreshment.
|
|
+Only one source is refreshed at a time and only when a valid response is
|
|
+received (unreachable sources are replaced independently). The default value is
|
|
+1209600 (2 weeks) and the maximum value is 2^31\-1 (68 years). A value of 0
|
|
+disables the periodic refreshment.
|
|
.sp
|
|
The \fBrefresh\fP command can be used to refresh all
|
|
sources immediately.
|