chiark / gitweb /
man: extend a bit what to expect from the various places apps can store data
[elogind.git] / man / systemd.timer.xml
index b60199c2f7fb696ca4607fdec8e40b35d3125096..d82b9bdc973b09846231bbef88799a855ab8e557 100644 (file)
                                 <term><varname>Persistent=</varname></term>
 
                                 <listitem><para>Takes a boolean
-                                argument. If true the service unit is
-                                immediately triggered when the timer
-                                unit is activated and the timer
-                                elapsed at least once since the last
-                                time the service unit has been
-                                triggered by the timer unit. The time
-                                when the service unit was last
-                                triggered is stored on disk. This is
-                                useful to catch up for missed timers
-                                when a machine is shutdown temporarily
-                                and then is powered up again. Note
-                                that this setting only has an effect
-                                on timers configured with
-                                <varname>OnCalendar=</varname>.
+                                argument. If true, the time when the
+                                service unit was last triggered is
+                                stored on disk. When the timer is
+                                activated, the service unit is
+                                triggered immediately if it would have
+                                been triggered at least once during
+                                the time when the timer was inactive.
+                                This is useful to catch up on missed
+                                runs of the service when the machine
+                                was off. Note that this setting only
+                                has an effect on timers configured
+                                with <varname>OnCalendar=</varname>.
                                 </para></listitem>
                         </varlistentry>
+
+                        <varlistentry>
+                                <term><varname>WakeSystem=</varname></term>
+
+                                <listitem><para>Takes a boolean
+                                argument. If true, an elapsing timer
+                                will cause the system to resume from
+                                suspend, should it be suspended and if
+                                the system supports this. Note that
+                                this option will only make sure the
+                                system resumes on the appropriate
+                                times, it will not take care of
+                                suspending it again after any work
+                                that is to be done is
+                                finished. Defaults to
+                                <varname>false</varname>.</para></listitem>
+                        </varlistentry>
                 </variablelist>
         </refsect1>