X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.timer.xml;h=659bc81ccd9d69f2245c6d017b48a6a0687a5d1a;hb=f8f14b3654bcd8d6c6cfd118e50775f6a2328a35;hp=9b6b486bf43f353dac6f52af7a0ec111a55f7c57;hpb=19c5f19d69bb5f520fa7213239490c55de06d99d;p=elogind.git
diff --git a/man/systemd.timer.xml b/man/systemd.timer.xml
index 9b6b486bf..659bc81cc 100644
--- a/man/systemd.timer.xml
+++ b/man/systemd.timer.xml
@@ -9,16 +9,16 @@
Copyright 2010 Lennart Poettering
systemd is free software; you can redistribute it and/or modify it
- under the terms of the GNU General Public License as published by
- the Free Software Foundation; either version 2 of the License, or
+ under the terms of the GNU Lesser General Public License as published by
+ the Free Software Foundation; either version 2.1 of the License, or
(at your option) any later version.
systemd is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
+ Lesser General Public License for more details.
- You should have received a copy of the GNU General Public License
+ You should have received a copy of the GNU Lesser General Public License
along with systemd; If not, see .
-->
@@ -44,18 +44,18 @@
systemd.timer
- systemd timer configuration files
+ Timer unit configuration
- systemd.timer
+ timer.timer
Description
A unit configuration file whose name ends in
- .timer encodes information about
+ .timer encodes information about
a timer controlled and supervised by systemd, for
timer-based activation.
@@ -97,7 +97,7 @@
defines. The options specific to the [Timer] section
of timer units are the following:
-
+
OnActiveSec=
OnBootSec=
@@ -105,7 +105,7 @@
OnUnitActiveSec=
OnUnitInactiveSec=
- Defines timers
+ Defines monotonic timers
relative to different starting points:
OnActiveSec= defines a
timer relative to the moment the timer
@@ -115,7 +115,7 @@
machine was booted
up. OnStartupSec=
defines a timer relative to when
- systemd was
+ systemd was first
started. OnUnitActiveSec=
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
OnBootSec= and
- OnUnitActiveSec= it is
+ OnUnitActiveSec=, it is
possible to define a timer that
elapses in regular intervals and
activates a specific service each
@@ -139,8 +139,8 @@
seconds. Example: "OnBootSec=50" means
50s after boot-up. The argument may
also include time units. Example:
- "OnBootSec=5h 30min" means 5 hours and 30
- minutes after boot-up. For details
+ "OnBootSec=5h 30min" means 5 hours and
+ 30 minutes after boot-up. For details
about the syntax of time spans see
systemd.unit5.
@@ -152,21 +152,42 @@
elapse and the configured unit is
started. This is not the case for
timers defined in the other
- directives.
+ directives.
These are monotonic timers,
independent of wall-clock time and timezones. If the
computer is temporarily suspended, the
monotonic clock stops too.
+ 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.
+
+
+
+ OnCalendar=
+
+ Defines realtime
+ (i.e. wallclock) timers via calendar
+ event expressions. See
+ systemd.time7
+ for more information on the syntax of
+ calendar event expressions. Otherwise
+ the semantics are similar to
+ OnActiveSec= and
+ related settings.
+
+
Unit=
The unit to activate
when this timer elapses. The argument is a
unit name, whose suffix is not
- .timer. If not
+ .timer. If not
specified, this value defaults to a
service that has the same name as the
timer unit, except for the
@@ -185,7 +206,9 @@
systemd1,
systemctl8,
systemd.unit5,
- systemd.service5
+ systemd.service5,
+ systemd.time7,
+ systemd.directives7