]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
man: document the two new .timer settings
authorLennart Poettering <lennart@poettering.net>
Thu, 14 Mar 2019 22:28:46 +0000 (23:28 +0100)
committerLennart Poettering <lennart@poettering.net>
Tue, 2 Apr 2019 06:20:10 +0000 (08:20 +0200)
man/systemd-run.xml
man/systemd.timer.xml

index 4dd81395cdaaedaa2944ca0db65d3654725dfcb2..8f7a6229cc9c85eee398dd82c42bd474256d780b 100644 (file)
         </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>
index f1afcf6b7ea1cf51a23b4604b79376a9ee14b252..6a13e52ccf854dfc0bce9f0ac9294ba6f966635d 100644 (file)
         <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>