From: Lennart Poettering <lennart@poettering.net>
Date: Thu, 14 Mar 2019 22:28:46 +0000 (+0100)
Subject: man: document the two new .timer settings
X-Git-Tag: v242-rc1~14^2~1
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=d9b8c2ef8bc4bcd3bfbdecad9fa7d3dceeb65a93;p=thirdparty%2Fsystemd.git

man: document the two new .timer settings
---

diff --git a/man/systemd-run.xml b/man/systemd-run.xml
index 4dd81395cda..8f7a6229cc9 100644
--- a/man/systemd-run.xml
+++ b/man/systemd-run.xml
@@ -316,6 +316,18 @@
         </listitem>
       </varlistentry>
 
+      <varlistentry>
+        <term><option>--on-clock-change</option></term>
+        <term><option>--on-timezone-change</option></term>
+
+        <listitem><para>Defines a trigger based on system clock jumps or timezone changes for starting the
+        specified command. See <varname>OnClockChange=</varname> and <varname>OnTimezoneChange=</varname> in
+        <citerefentry><refentrytitle>systemd.timer</refentrytitle><manvolnum>5</manvolnum></citerefentry>. These
+        options are shortcuts for <command>--timer-property=OnClockChange=yes</command> and
+        <command>--timer-property=OnTimezoneChange=yes</command>. These options may not be combined with
+        <option>--scope</option> or <option>--pty</option>.</para></listitem>
+      </varlistentry>
+
       <varlistentry>
         <term><option>--path-property=</option></term>
         <term><option>--socket-property=</option></term>
diff --git a/man/systemd.timer.xml b/man/systemd.timer.xml
index f1afcf6b7ea..6a13e52ccf8 100644
--- a/man/systemd.timer.xml
+++ b/man/systemd.timer.xml
@@ -259,6 +259,17 @@
         <varname>AccuracySec=1us</varname>.</para></listitem>
       </varlistentry>
 
+      <varlistentry>
+        <term><varname>OnClockChange=</varname></term>
+        <term><varname>OnTimezoneChange=</varname></term>
+
+        <listitem><para>These options take boolean arguments. When true, the service unit will be triggered
+        when the system clock (<constant>CLOCK_REALTIME</constant>) jumps relative to the monotonic clock
+        (<constant>CLOCK_MONOTONIC</constant>), or when the local system timezone is modified. These options
+        can be used alone or in combination with other timer expressions (see above) within the same timer
+        unit. These options default to false.</para></listitem>
+      </varlistentry>
+
       <varlistentry>
         <term><varname>Unit=</varname></term>