summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorDimitry Ishenko <dimitry.ishenko@gmail.com>2021-07-07 13:54:47 -0400
committerLennart Poettering <lennart@poettering.net>2021-08-09 21:06:28 +0200
commit33e82f3ef33a2497f9838a5fbb924c7501d8dd9e (patch)
tree1aa4934bc6101cedc779e9d7ba6367e9d283d25d /man
parent8a513eee30ac5128d3176bec90c8ed118764c54f (diff)
downloadsystemd-33e82f3ef33a2497f9838a5fbb924c7501d8dd9e.tar.gz
timesync: add option to periodically save time
Diffstat (limited to 'man')
-rw-r--r--man/systemd-timesyncd.service.xml9
-rw-r--r--man/timesyncd.conf.xml12
2 files changed, 17 insertions, 4 deletions
diff --git a/man/systemd-timesyncd.service.xml b/man/systemd-timesyncd.service.xml
index 9ab4af9763..34e0a67472 100644
--- a/man/systemd-timesyncd.service.xml
+++ b/man/systemd-timesyncd.service.xml
@@ -75,10 +75,11 @@
<term><filename>/var/lib/systemd/timesync/clock</filename></term>
<listitem>
- <para>The modification time ("mtime") of this file indicates the timestamp of the last successful
- synchronization (or at least the systemd build date, in case synchronization was not possible). It
- is used to ensure that the system clock remains roughly monotonic across reboots, in case no local
- RTC is available.</para>
+ <para>The modification time ("mtime") of this file is updated on each successful NTP synchronization
+ or after each <varname>SaveIntervalSec=</varname> time interval, as specified in
+ <citerefentry><refentrytitle>timesyncd.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
+ At the minimum, it will be set to the systemd build date. It is used to ensure that the system clock
+ remains roughly monotonic across reboots, in case no local RTC is available.</para>
</listitem>
</varlistentry>
diff --git a/man/timesyncd.conf.xml b/man/timesyncd.conf.xml
index 3fd11cea04..07472cdb39 100644
--- a/man/timesyncd.conf.xml
+++ b/man/timesyncd.conf.xml
@@ -103,6 +103,18 @@
Defaults to 30 seconds and must not be smaller than 1 second.</para></listitem>
</varlistentry>
+ <varlistentry>
+ <term><varname>SaveIntervalSec=</varname></term>
+ <listitem><para>The interval at which the current time is periodically saved to disk, in the absence
+ of any recent synchronisation from an NTP server. This is especially useful for offline systems
+ with no local RTC, as it will guarantee that the system clock remains roughly monotonic across
+ reboots.</para>
+
+ <para>Takes a time interval value. The default unit is seconds, but other units may be specified, see
+ <citerefentry><refentrytitle>systemd.time</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
+ Defaults to 60 seconds.</para></listitem>
+ </varlistentry>
+
</variablelist>
</refsect1>