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 <http://www.gnu.org/licenses/>.
-->
<refnamediv>
<refname>systemd.timer</refname>
- <refpurpose>systemd timer configuration files</refpurpose>
+ <refpurpose>Timer unit configuration</refpurpose>
</refnamediv>
<refsynopsisdiv>
<variablelist>
<varlistentry>
- <term><varname>OnActive=</varname></term>
- <term><varname>OnBootup=</varname></term>
- <term><varname>OnStartup=</varname></term>
- <term><varname>OnUnitActive=</varname></term>
- <term><varname>OnUnitInactive=</varname></term>
+ <term><varname>OnActiveSec=</varname></term>
+ <term><varname>OnBootSec=</varname></term>
+ <term><varname>OnStartupSec=</varname></term>
+ <term><varname>OnUnitActiveSec=</varname></term>
+ <term><varname>OnUnitInactiveSec=</varname></term>
<listitem><para>Defines timers
relative to different starting points:
- <varname>OnActive=</varname> defines a
+ <varname>OnActiveSec=</varname> defines a
timer relative to the moment the timer
itself is
- activated. <varname>OnBootup=</varname>
+ activated. <varname>OnBootSec=</varname>
defines a timer relative to when the
machine was booted
- up. <varname>OnStartup=</varname>
+ up. <varname>OnStartupSec=</varname>
defines a timer relative to when
systemd was
- started. <varname>OnUnitActive=</varname>
+ started. <varname>OnUnitActiveSec=</varname>
defines a timer relative to when the
unit the timer is activating was last
- activated. <varname>OnUnitInactive=</varname>
+ activated. <varname>OnUnitInactiveSec=</varname>
defines a timer relative to when the
unit the timer is activating was last
deactivated.</para>
<para>Multiple directives may be
combined of the same and of different
types. For example, by combining
- <varname>OnBoot=</varname> and
- <varname>OnUnitActive=</varname> it is
+ <varname>OnBootSec=</varname> and
+ <varname>OnUnitActiveSec=</varname> it is
possible to define a timer that
elapses in regular intervals and
activates a specific service each
<para>The arguments to the directives
are time spans configured in
- seconds. Example: "OnBoot=50" means
+ seconds. Example: "OnBootSec=50" means
50s after boot-up. The argument may
also include time units. Example:
- "OnBoot=5h 30min" means 5 hours and 30
+ "OnBootSec=5h 30min" means 5 hours and 30
minutes after boot-up. For details
about the syntax of time spans see
<citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
<para>If a timer configured with
- <varname>OnBootup=</varname> or
- <varname>OnStartup=</varname> is
+ <varname>OnBootSec=</varname> or
+ <varname>OnStartupSec=</varname> is
already in the past when the timer
unit is activated, it will immediately
elapse and the configured unit is
specified, this value defaults to a
service that has the same name as the
timer unit, except for the
- suffix. (See above.) It is recommended,
+ suffix. (See above.) It is recommended
that the unit name that is activated
and the unit name of the timer unit
- are named identical, except for the
+ are named identically, except for the
suffix.</para></listitem>
</varlistentry>
</variablelist>
<refsect1>
<title>See Also</title>
<para>
- <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
+ <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</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>