chiark / gitweb /
hashmap: add OrderedHashmap as a distinct type
[elogind.git] / man / systemd.timer.xml
index 58eaab09f84625cbb20d109067a5b5aa625bcb5b..55b458557f357634ae7f27591cbd8cddf7001e30 100644 (file)
                 <varname>Unit=</varname> (see below).</para>
 
                 <para>Unless <varname>DefaultDependencies=</varname>
                 <varname>Unit=</varname> (see below).</para>
 
                 <para>Unless <varname>DefaultDependencies=</varname>
-                is set to <option>false</option>, timer units will
+                is set to <option>false</option>, all timer units will
                 implicitly have dependencies of type
                 <varname>Conflicts=</varname> and
                 <varname>Before=</varname> on
                 implicitly have dependencies of type
                 <varname>Conflicts=</varname> and
                 <varname>Before=</varname> on
-                <filename>shutdown.target</filename>. These ensure
-                that timer units are stopped cleanly prior to system
-                shutdown. Only timer units involved with early boot or
-                late system shutdown should disable this
-                option.</para>
+                <filename>shutdown.target</filename> to ensure that
+                they are stopped cleanly prior to system shutdown.
+                Timer units with at least one
+                <varname>OnCalendar=</varname> directive will have an
+                additional <varname>After=</varname> dependency on
+                <filename>timer-sync.target</filename> to avoid
+                being started before the system clock has been
+                correctly set. Only timer units involved with early
+                boot or late system shutdown should disable the
+                <varname>DefaultDependencies=</varname> option.</para>
         </refsect1>
 
         <refsect1>
         </refsect1>
 
         <refsect1>
                                 <term><varname>Persistent=</varname></term>
 
                                 <listitem><para>Takes a boolean
                                 <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>
 
                                 </para></listitem>
                         </varlistentry>
 
                                 <term><varname>WakeSystem=</varname></term>
 
                                 <listitem><para>Takes a boolean
                                 <term><varname>WakeSystem=</varname></term>
 
                                 <listitem><para>Takes a boolean
-                                argument. If true an elapsing timer
+                                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
                                 will cause the system to resume from
                                 suspend, should it be suspended and if
                                 the system supports this. Note that
                   <title>See Also</title>
                   <para>
                           <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
                   <title>See Also</title>
                   <para>
                           <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
-                          <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
+                          <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
                           <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
                           <citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
                           <citerefentry><refentrytitle>systemd.time</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
                           <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
                           <citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
                           <citerefentry><refentrytitle>systemd.time</refentrytitle><manvolnum>7</manvolnum></citerefentry>,