chiark
/
gitweb
/
~ianmdlvl
/
elogind.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
Add a bit more explicit message, to help confused users
[elogind.git]
/
man
/
systemd.timer.xml
diff --git
a/man/systemd.timer.xml
b/man/systemd.timer.xml
index 5cc543e453ea42bfcf14af138beb2d09b31ff3c9..659bc81ccd9d69f2245c6d017b48a6a0687a5d1a 100644
(file)
--- a/
man/systemd.timer.xml
+++ b/
man/systemd.timer.xml
@@
-48,14
+48,14
@@
</refnamediv>
<refsynopsisdiv>
</refnamediv>
<refsynopsisdiv>
- <para><filename>
systemd
.timer</filename></para>
+ <para><filename>
<replaceable>timer</replaceable>
.timer</filename></para>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para>A unit configuration file whose name ends in
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para>A unit configuration file whose name ends in
- <
filename>.timer</filename
> encodes information about
+ <
literal>.timer</literal
> encodes information about
a timer controlled and supervised by systemd, for
timer-based activation.</para>
a timer controlled and supervised by systemd, for
timer-based activation.</para>
@@
-97,7
+97,7
@@
defines. The options specific to the [Timer] section
of timer units are the following:</para>
defines. The options specific to the [Timer] section
of timer units are the following:</para>
- <variablelist>
+ <variablelist
class='unit-directives'
>
<varlistentry>
<term><varname>OnActiveSec=</varname></term>
<term><varname>OnBootSec=</varname></term>
<varlistentry>
<term><varname>OnActiveSec=</varname></term>
<term><varname>OnBootSec=</varname></term>
@@
-115,7
+115,7
@@
machine was booted
up. <varname>OnStartupSec=</varname>
defines a timer relative to when
machine was booted
up. <varname>OnStartupSec=</varname>
defines a timer relative to when
- systemd was
+ systemd was
first
started. <varname>OnUnitActiveSec=</varname>
defines a timer relative to when the
unit the timer is activating was last
started. <varname>OnUnitActiveSec=</varname>
defines a timer relative to when the
unit the timer is activating was last
@@
-128,7
+128,7
@@
combined of the same and of different
types. For example, by combining
<varname>OnBootSec=</varname> and
combined of the same and of different
types. For example, by combining
<varname>OnBootSec=</varname> and
- <varname>OnUnitActiveSec=</varname> it is
+ <varname>OnUnitActiveSec=</varname>
,
it is
possible to define a timer that
elapses in regular intervals and
activates a specific service each
possible to define a timer that
elapses in regular intervals and
activates a specific service each
@@
-157,7
+157,13
@@
<para>These are monotonic timers,
independent of wall-clock time and timezones. If the
computer is temporarily suspended, the
<para>These are monotonic timers,
independent of wall-clock time and timezones. If the
computer is temporarily suspended, the
- monotonic clock stops too.</para></listitem>
+ monotonic clock stops too.</para>
+
+ <para>If the empty string is assigned
+ to any of these options, the list of
+ timers is reset, and all prior
+ assignments will have no
+ effect.</para></listitem>
</varlistentry>
</varlistentry>
@@
-169,8
+175,10
@@
event expressions. See
<citerefentry><refentrytitle>systemd.time</refentrytitle><manvolnum>7</manvolnum></citerefentry>
for more information on the syntax of
event expressions. See
<citerefentry><refentrytitle>systemd.time</refentrytitle><manvolnum>7</manvolnum></citerefentry>
for more information on the syntax of
- calendar event
- expressions.</para></listitem>
+ calendar event expressions. Otherwise
+ the semantics are similar to
+ <varname>OnActiveSec=</varname> and
+ related settings.</para></listitem>
</varlistentry>
<varlistentry>
</varlistentry>
<varlistentry>
@@
-179,7
+187,7
@@
<listitem><para>The unit to activate
when this timer elapses. The argument is a
unit name, whose suffix is not
<listitem><para>The unit to activate
when this timer elapses. The argument is a
unit name, whose suffix is not
- <
filename>.timer</filename
>. If not
+ <
literal>.timer</literal
>. If not
specified, this value defaults to a
service that has the same name as the
timer unit, except for the
specified, this value defaults to a
service that has the same name as the
timer unit, except for the
@@
-199,7
+207,8
@@
<citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>8</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.time</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
+ <citerefentry><refentrytitle>systemd.directives</refentrytitle><manvolnum>7</manvolnum></citerefentry>
</para>
</refsect1>
</para>
</refsect1>