diff options
author | Lennart Poettering <lennart@poettering.net> | 2019-03-25 18:51:14 +0100 |
---|---|---|
committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2019-03-25 20:32:18 +0100 |
commit | c49357e7477564b98d977e35393f471d2088dc19 (patch) | |
tree | 18eae8a1d9725fcccc6c410c3dc8d5ef40082ea2 /man | |
parent | 60a3e982f44778142b5adce96f2caaa0a11b6d54 (diff) | |
download | systemd-c49357e7477564b98d977e35393f471d2088dc19.tar.gz |
man: rework timer docs to use a table for monotonic timers
Diffstat (limited to 'man')
-rw-r--r-- | man/systemd.timer.xml | 46 |
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 |