shaba/systemd
1
0
Fork 0
mirror of https://github.com/systemd/systemd.git synced 2024-12-22 17:35:35 +03:00
Code

man: mention that OnCalendar= combines well with systemd-time-wait-sync.service

Browse Source 
Fixes: #23440
This commit is contained in:
Lennart Poettering 2023-06-07 14:31:02 +02:00 committed by Luca Boccassi
parent 3c6fefd879
commit 9e7e9c72c4
1 changed files with 14 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
man/systemd.timer.xml
View File

@ -187,17 +187,13 @@
<varlistentry> <varlistentry>
<term><varname>OnCalendar=</varname></term> <term><varname>OnCalendar=</varname></term>
<listitem><para>Defines realtime (i.e. wallclock) timers with <listitem><para>Defines realtime (i.e. wallclock) timers with calendar event expressions. See
calendar event expressions. See <citerefentry><refentrytitle>systemd.time</refentrytitle><manvolnum>7</manvolnum></citerefentry> for
<citerefentry><refentrytitle>systemd.time</refentrytitle><manvolnum>7</manvolnum></citerefentry> more information on the syntax of calendar event expressions. Otherwise, the semantics are similar to
for more information on the syntax of calendar event
expressions. Otherwise, the semantics are similar to
<varname>OnActiveSec=</varname> and related settings.</para> <varname>OnActiveSec=</varname> and related settings.</para>
<para>Note that timers do not necessarily expire at the <para>Note that timers do not necessarily expire at the precise time configured with this setting, as
precise time configured with this setting, as it is subject to it is subject to the <varname>AccuracySec=</varname> setting below.</para>
the <varname>AccuracySec=</varname> setting
below.</para>
<para>May be specified more than once, in which case the timer unit will trigger whenever any of the <para>May be specified more than once, in which case the timer unit will trigger whenever any of the
specified expressions elapse. Moreover calendar timers and monotonic timers (see above) may be specified expressions elapse. Moreover calendar timers and monotonic timers (see above) may be
@ -205,7 +201,15 @@
<para>If the empty string is assigned to any of these options, the list of timers is reset (both <para>If the empty string is assigned to any of these options, the list of timers is reset (both
<varname>OnCalendar=</varname> timers and monotonic timers, see above), and all prior assignments <varname>OnCalendar=</varname> timers and monotonic timers, see above), and all prior assignments
will have no effect.</para></listitem> will have no effect.</para>
<para>Note that calendar timers might be triggered at unexpected times if the system's realtime clock
is not set correctly. Specifically, on systems that lack a battery-buffered Realtime Clock (RTC) it
might be wise to enable <filename>systemd-time-wait-sync.service</filename> to ensure the clock is
adjusted to a network time source <emphasis>before</emphasis> the timer event is set up. Timer units
with at least one <varname>OnCalendar=</varname> expression are automatically ordered after
<filename>time-sync.target</filename>, which <filename>systemd-time-wait-sync.service</filename> is
ordered before.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>