summaryrefslogtreecommitdiff
path: root/man/systemd.timer.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2019-03-25 18:51:14 +0100
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2019-03-25 20:32:18 +0100
commitc49357e7477564b98d977e35393f471d2088dc19 (patch)
tree18eae8a1d9725fcccc6c410c3dc8d5ef40082ea2 /man/systemd.timer.xml
parent60a3e982f44778142b5adce96f2caaa0a11b6d54 (diff)
downloadsystemd-c49357e7477564b98d977e35393f471d2088dc19.tar.gz
man: rework timer docs to use a table for monotonic timers
Diffstat (limited to 'man/systemd.timer.xml')
-rw-r--r--man/systemd.timer.xml46
1 files changed, 36 insertions, 10 deletions
diff --git a/man/systemd.timer.xml b/man/systemd.timer.xml
index 90aa2a4417..ac00d2aec2 100644
--- a/man/systemd.timer.xml
+++ b/man/systemd.timer.xml
@@ -105,16 +105,42 @@
<term><varname>OnUnitInactiveSec=</varname></term>
<listitem><para>Defines monotonic timers relative to different
- starting points: <varname>OnActiveSec=</varname> defines a
- timer relative to the moment the timer itself is activated.
- <varname>OnBootSec=</varname> defines a timer relative to when
- the machine was booted up. <varname>OnStartupSec=</varname>
- defines a timer relative to when systemd was first started.
- <varname>OnUnitActiveSec=</varname> defines a timer relative
- to when the unit the timer is activating was last activated.
- <varname>OnUnitInactiveSec=</varname> defines a timer relative
- to when the unit the timer is activating was last
- deactivated.</para>
+ starting points:</para>
+
+ <table>
+ <title>Settings and their starting points</title>
+
+ <tgroup cols='2'>
+ <thead>
+ <row>
+ <entry>Setting</entry>
+ <entry>Meaning</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><varname>OnActiveSec=</varname></entry>
+ <entry>Defines a timer relative to the moment the timer unit itself is activated.</entry>
+ </row>
+ <row>
+ <entry><varname>OnBootSec=</varname></entry>
+ <entry>Defines a timer relative to when the machine was booted up.</entry>
+ </row>
+ <row>
+ <entry><varname>OnStartupSec=</varname></entry>
+ <entry>Defines a timer relative to when the service manager was first started. For system timer units this is very similar to <varname>OnBootSec=</varname> as the system service manager is generally started very early at boot. It's primarily useful when configured in units running in the per-user service manager, as the user service manager is generally started on first login only, not already during boot.</entry>
+ </row>
+ <row>
+ <entry><varname>OnUnitActiveSec=</varname></entry>
+ <entry>Defines a timer relative to when the unit the timer unit is activating was last activated.</entry>
+ </row>
+ <row>
+ <entry><varname>OnUnitInactiveSec=</varname></entry>
+ <entry>Defines a timer relative to when the unit the timer unit is activating was last deactivated.</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
<para>Multiple directives may be combined of the same and of
different types. For example, by combining