Systemd.timer: Unterschied zwischen den Versionen

Aktuelle Version vom 26. Oktober 2025, 09:36 Uhr

systemd.timer - Systemd Timer Units

Beschreibung

Timer Unit

Beschreibt, wann eine Service Unit ausgeführt werden soll

Aufgaben übernehmen, welche traditionell von Cron ausgeführt werden

Flexibilität

Timer Units führen Befehle aus

zu einem festen Zeitpunkt ("um Mitternacht")
relativ zum Systemstart ("5 Minuten später")

Anwendung

Aktivierung

Timer aktivieren

Timer Units aktivieren

Nach der Erstellung müssen Timer Unitsaktiviert und gestartet werden

sudo systemctl enable name_des_timers.timer
sudo systemctl start name_des_timers.timer

Ausführungszeitpunkte

Schlüssel für relative Ausführungszeitpunkte

Schlüssel	Beschreibung
OnActiveSec	relativ zur letzten Timer-Unit-Aktivierung
OnBootSec	relativ zum letzten Neustart des Rechners
OnStartupSec	relative Zeit bezogen auf den Zeitpunkt, als systemd gestartet wurde
OnUnitActiveSec	relative Zeit bezogen auf den Zeitpunkt, als die Service Unit zuletzt aktiviert wurde
OnUnitInactiveSec	relative Zeit bezogen auf den Zeitpunkt, als die Service Unit zuletzt deaktiviert wurde

Absolute Zeitangaben

Diese werden im Schlüssel OnCalendar angeben
So würde z.B
die folgende Timer Unit:

1 2 3 4 5 6 7 8 9	[Unit] Description=Eine kurze Beschreibung des Timers [Timer] OnCalendar=Mon-Fri --* 12:00:00 Unit=name_der_zu_startenden_unit.service [Install] WantedBy=multi-user.target

die Service Unit name_der_zu_startenden_unit.service an jedem Tag von Montag bis Freitag um 12 Uhr ausführen

Zeitangaben

Die Timer von systemd kennen eine Vielzahl von Zeiteinheiten

Die kleinste Zeiteinheit sind Mikrosekunden, die größte Jahre
Eine komplette Übersicht inklusive der Einheiten ist in der Dokumentation von systemd zu finden

Für die Werte des OnCalendar Schlüssel kennt systemd eine flexible Syntax zur Zeitangabe

So steht z.B
der Wert Thu,Fri 2016-*-1,5 11:12:13 für:
am 1
und 5
jedes Monats im Jahr 2016 um 11 Uhr, 12 Minuten und 13 Sekunden ausführen
aber nur, wenn diese Tage ein Donnerstag oder Freitag sind

Eine vollständige Übersicht inklusive vieler Beispiele findet man in der Dokumentation von systemd

Verpasste Timer

Verpasste Timer nachholen

Möchte man eine Timer-Unit auch nachträglich ausführen lassen

also etwa falls der Rechner zum Zeitpunkt der Fälligkeit des Timers ausgeschaltet war
muss man im Abschnitt [Timer] zusätzlich die Direktive

Persistent=true

setzen

Voreinstellung

Die Voreinstellung von systemd ist hier false

verpasste Timer werden nicht nachgeholt
Die Direktive funktioniert nur in Kombination mit der OnCalendar Direktive, nicht mit anderen Direktiven für Zeitpunkte

at Ersatz

Neben den Aufgaben

die traditionell Cron erledigt

kann systemd auch die typische Aufgabe von at übernehmen

einen Job nur ein einziges mal zu einem bestimmten Zeitpunkt zu starten

Es muss kein Script angelegt werden, sondern es genügt das Abschicken eines Befehls im Terminal

Beispiel

Als root

sudo systemd-run --on-calendar="2022-01-30 20:01:35" touch /tmp/testfile

Als normaler User

systemd-run --user --on-calendar="2022-01-30 20:01:35" touch ~/testfile

Diese Timer werden in den Verzeichnissen

/run/systemd/transient (systemweit)
und für Benutzer in /run/user/<uid>/systemd/transient angelegt

Dabei wird standardmäßig ein zufälliger Name generiert

Man kann den Namen des Timers aber auch explizit mit der Option --unit= festlegen

Genauigkeit

Per Voreinstellung haben die Timer eine Genauigkeit von einer Minute, d.h aller spätestens eine Minute nach der in der .timer Datei angegebenen Zeit wird die vom Timer aufgerufene Service Unit aufgerufen

Wer für einzelne Timer Units einen genaueren Ausführungszeitraum braucht, der kann in der Sektion "[Timer]" zusätzlich den Schlüssel AccuracySec angeben, gefolgt von einer Zeitangabe

So würde beispielsweise AccuracySec=5s die Genauigkeit auf 5 Sekunden setzen

Wer eine höhere Genauigkeit für alle Timer systemweit benötigt, der hinterlegt den gewünschten Wert in der Konfigurationsdatei /etc/systemd/system.conf

Aufgrund dieser Tatsache kann nicht eindeutig die verbleibende Zeit bis zum Trigger ermittelt werden

Dieser Umstand wird im unix.stackexchange ausführlich beschrieben
Darüber hinaus gibt es noch die Möglichkeit mit RandomizedDelaySec eine absichtliche gleichverteilt zufällige Verzögerung zu erzeugen

Timer stoppen/deaktivieren

Stoppen

Wie alle anderen Systemd-Units lassen sich Timer stoppen

sudo systemctl stop name_des_timers.timer

Deaktivieren

Sofern Timer wiederkehrend mit dem System-Start aktiviert wurden, deaktiviert man sie unter Verwendung von

sudo systemctl disable name_des_timers.timer

systemd-run

Bei mittels systemd-run angelegten Timern muss berücksichtigt werden, dass das System für diese zwei Dateien pro Timer generiert; eine mit der Endung .service und eine mit der Endung .timer

Dementsprechend stopt man diese mittels

sudo systemctl stop name_des_timers.{service,timer}

Die systemd-run-Timer werden damit auch gleichzeitig aus den betreffenden Verzeichnissen gelöscht, sodass sie gegebenenfalls durch erneutes Anlegen mittels systemd-run neu eingerichtet werden müssen

Konfiguration

Aufbau

Aufbau eine Timer Unit

Textdatei

Ähnlich einer INI-Dateien
Der Dateiname kann frei gewählt werden, muss aber auf .timer enden

Selbsterstellte Timer

Selbsterstellte Timer werden

/etc/systemd/system
Root-Rechte erforderlich

[Unit]
Description=Eine kurze Beschreibung des Timers

[Timer]
OnBootSec=2min
OnUnitActiveSec=5min
Unit=name_der_zu_startenden_unit.service

[Install]
WantedBy=multi-user.target

Sektionen

Sektion	Beschreibung
[Unit]
[Timer]
[Install]

Die Bedeutung der Sektionen "[Unit]" und "[Install]"

identisch mit der von Service Units
Die Sektion "[Timer]" enthält dabei die Informationen, wann die im Schlüssel Unit hinterlegte Unit ausgeführt werden soll

Beispiel

würde die Unit namens name_der_zu_startenden_unit.service wie folgt ausgeführt

OnBootSec=2min - erste Ausführung 2 Minuten nach Beginn des Bootvorgangs
OnUnitActiveSec=5min - weitere Ausführungen jeweils 5 Minuten, nachdem die Service Unit zu letzten Mal gestartet wurde

Dateien

Datei	Beschreibung

Anhang

Siehe auch

Dokumentation

Links

Projekt

Weblinks

@@ Zeile 4: / Zeile 4: @@
 ; Timer Unit
 Beschreibt, wann eine [[Service Unit]] ausgeführt werden soll
-* Kann Aufgaben übernehmen, welche traditionell von [[Cron]] ausgeführt werden
+* Aufgaben übernehmen, welche traditionell von [[Cron]] ausgeführt werden
 ; Flexibilität
@@ Zeile 14: / Zeile 14: @@
 === Anzeige ===
 Timer anzeigen
-; Systemweite Timer
+; System Timer
 <syntaxhighlight lang="bash" highlight="1" line copy>
 sudo systemctl list-timers
@@ Zeile 24: / Zeile 24: @@
 </syntaxhighlight>
-; Inaktiven Timer
+; Inaktive Timer
 <syntaxhighlight lang="bash" highlight="1" line copy>
 sudo systemctl --user list-timers --all
@@ Zeile 39: / Zeile 39: @@
 === Ausführungszeitpunkte ===
-Timer Units kennen fünf verschiedene Schlüssel für relative Ausführungszeitpunkte:
+; Schlüssel für relative Ausführungszeitpunkte
 {| class="wikitable options big"
 |-
 ! Schlüssel !! Beschreibung
 |-
-|| <tt>OnActiveSec</tt>
+|| OnActiveSec
-|| relative Zeit bezogen auf den Zeitpunkt, als die Timer Unit zuletzt aktiviert wurde
+|| relativ zur letzten Timer-Unit-Aktivierung
 |-
-|| <tt>OnBootSec</tt>
+|| OnBootSec
-|| relative Zeit bezogen auf den Zeitpunkt, als der Rechner gestartet wurde
+|| relativ zum letzten Neustart des Rechners
 |-
-|| <tt>OnStartupSec</tt>
+|| OnStartupSec
 || relative Zeit bezogen auf den Zeitpunkt, als systemd gestartet wurde
 |-
-|| <tt>OnUnitActiveSec</tt>
+|| OnUnitActiveSec
 || relative Zeit bezogen auf den Zeitpunkt, als die Service Unit zuletzt aktiviert wurde
 |-
-|| <tt>OnUnitInactiveSec</tt>
+|| OnUnitInactiveSec
 || relative Zeit bezogen auf den Zeitpunkt, als die Service Unit zuletzt deaktiviert wurde
 |-
 |}
-Außerdem kennen Timer Units noch absolute Zeitangaben
+; Absolute Zeitangaben
-* Diese werden im Schlüssel <tt>OnCalendar</tt> angeben
+* Diese werden im Schlüssel OnCalendar angeben
 * So würde z.B
 * die folgende Timer Unit:
@@ Zeile 97: / Zeile 96: @@
 * Eine komplette Übersicht inklusive der Einheiten ist in der [http://www.freedesktop.org/software/systemd/man/systemd.time.html#Parsing%20Time%20Spans Dokumentation] von systemd zu finden
-Für die Werte des <tt>OnCalendar</tt> Schlüssel kennt systemd eine flexible Syntax zur Zeitangabe
+Für die Werte des OnCalendar Schlüssel kennt systemd eine flexible Syntax zur Zeitangabe
 * So steht z.B
-* der Wert <tt>Thu,Fri 2016-*-1,5 11:12:13</tt> für:
+* der Wert Thu,Fri 2016-*-1,5 11:12:13 für:
 * am 1
 * und 5
@@ Zeile 111: / Zeile 110: @@
 Möchte man eine Timer-Unit auch nachträglich ausführen lassen
 * also etwa falls der Rechner zum Zeitpunkt der Fälligkeit des Timers ausgeschaltet war
-* muss man im Abschnitt <tt>[Timer]</tt> zusätzlich die Direktive
+* muss man im Abschnitt [Timer] zusätzlich die Direktive
   Persistent=true
 setzen
 ; Voreinstellung
-Die Voreinstellung von systemd ist hier <tt>false</tt>
+Die Voreinstellung von systemd ist hier false
 * verpasste Timer werden nicht nachgeholt
-* Die Direktive funktioniert nur in Kombination mit der <tt>OnCalendar</tt> Direktive, nicht mit anderen Direktiven für Zeitpunkte
+* Die Direktive funktioniert nur in Kombination mit der OnCalendar Direktive, nicht mit anderen Direktiven für Zeitpunkte
 === at Ersatz ===
-Neben den Aufgaben, die traditionell [https://wiki.ubuntuusers.de/Cron/ Cron] erledigt, kann systemd auch die typische Aufgabe von [https://wiki.ubuntuusers.de/at/ at] übernehmen, einen Job nur ein einziges mal zu einem bestimmten Zeitpunkt zu starten
+Neben den Aufgaben
+die traditionell [https://wiki.ubuntuusers.de/Cron/ Cron] erledigt
+kann systemd auch die typische Aufgabe von [https://wiki.ubuntuusers.de/at/ at] übernehmen
+einen Job nur ein einziges mal zu einem bestimmten Zeitpunkt zu starten
 * Es muss kein Script angelegt werden, sondern es genügt das Abschicken eines Befehls im Terminal
@@ Zeile 131: / Zeile 136: @@
   systemd-run --user --on-calendar="2022-01-30 20:01:35" touch ~/testfile
-Diese Timer werden in den Verzeichnissen '''/run/systemd/transient''' (systemweit) und für Benutzer in '''/run/user/<uid>/systemd/transient''' angelegt
+Diese Timer werden in den Verzeichnissen
-* Dabei wird standardmäßig ein zufälliger Name generiert
+* '''/run/systemd/transient''' (systemweit)
-* Man kann den Namen des Timers aber auch explizit mit der Option <tt>--unit=</tt> festlegen
+* und für Benutzer in '''/run/user/<uid>/systemd/transient''' angelegt
+Dabei wird standardmäßig ein zufälliger Name generiert
+* Man kann den Namen des Timers aber auch explizit mit der Option --unit= festlegen
 === Genauigkeit ===
 Per Voreinstellung haben die Timer eine Genauigkeit von einer Minute, d.h aller spätestens eine Minute nach der in der '''.timer''' Datei angegebenen Zeit wird die vom Timer aufgerufene Service Unit aufgerufen
-Wer für einzelne Timer Units einen genaueren Ausführungszeitraum braucht, der kann in der Sektion ''"[Timer]"'' zusätzlich den Schlüssel <tt>AccuracySec</tt> angeben, gefolgt von einer Zeitangabe
+Wer für einzelne Timer Units einen genaueren Ausführungszeitraum braucht, der kann in der Sektion ''"[Timer]"'' zusätzlich den Schlüssel AccuracySec angeben, gefolgt von einer Zeitangabe
-* So würde beispielsweise <tt>AccuracySec=5s</tt> die Genauigkeit auf 5 Sekunden setzen
+* So würde beispielsweise AccuracySec=5s die Genauigkeit auf 5 Sekunden setzen
 Wer eine höhere Genauigkeit für alle Timer systemweit benötigt, der hinterlegt den gewünschten Wert in der Konfigurationsdatei '''/etc/systemd/system.conf'''
@@ Zeile 145: / Zeile 153: @@
 Aufgrund dieser Tatsache kann nicht eindeutig die verbleibende Zeit bis zum Trigger ermittelt werden
 * Dieser Umstand wird im [https://unix.stackexchange.com/a/526906/427268 unix.stackexchange] ausführlich beschrieben
-* Darüber hinaus gibt es noch die Möglichkeit mit <tt>RandomizedDelaySec</tt> eine absichtliche gleichverteilt zufällige Verzögerung zu erzeugen
+* Darüber hinaus gibt es noch die Möglichkeit mit RandomizedDelaySec eine absichtliche gleichverteilt zufällige Verzögerung zu erzeugen
 === Timer stoppen/deaktivieren ===
@@ Zeile 161: / Zeile 169: @@
 ; systemd-run
-Bei mittels <tt>systemd-run</tt> angelegten Timern muss berücksichtigt werden, dass das System für diese zwei Dateien pro Timer generiert; eine mit der Endung '''.service''' und eine mit der Endung '''.timer'''
+Bei mittels systemd-run angelegten Timern muss berücksichtigt werden, dass das System für diese zwei Dateien pro Timer generiert; eine mit der Endung '''.service''' und eine mit der Endung '''.timer'''
 Dementsprechend stopt man diese mittels
@@ Zeile 168: / Zeile 176: @@
 </syntaxhighlight>
-Die <tt>systemd-run</tt>-Timer werden damit auch gleichzeitig aus den betreffenden Verzeichnissen gelöscht, sodass sie gegebenenfalls durch erneutes Anlegen mittels <tt>systemd-run</tt> neu eingerichtet werden müssen
+Die systemd-run-Timer werden damit auch gleichzeitig aus den betreffenden Verzeichnissen gelöscht, sodass sie gegebenenfalls durch erneutes Anlegen mittels systemd-run neu eingerichtet werden müssen
 == Konfiguration ==
@@ Zeile 196: / Zeile 204: @@
 === Sektionen ===
-{| class="wikitable options"
+{| class="wikitable options big"
 |-
-! Sektion  !! Beschreibung
+! Sektion !! Beschreibung
 |-
 | [Unit] ||
@@ Zeile 209: / Zeile 217: @@
 Die Bedeutung der Sektionen ''"[Unit]"'' und ''"[Install]"''
 * identisch mit der von [https://wiki.ubuntuusers.de/systemd/Service_Units/#Eigene-Service-Units-anlegen Service Units]
-* Die Sektion ''"[Timer]"'' enthält dabei die Informationen, wann die im Schlüssel <tt>Unit</tt> hinterlegte Unit ausgeführt werden soll
+* Die Sektion ''"[Timer]"'' enthält dabei die Informationen, wann die im Schlüssel Unit hinterlegte Unit ausgeführt werden soll
 ; Beispiel
 würde die Unit namens '''name_der_zu_startenden_unit.service''' wie folgt ausgeführt
-* <tt>OnBootSec=2min</tt> - erste Ausführung 2 Minuten nach Beginn des Bootvorgangs
+* OnBootSec=2min - erste Ausführung 2 Minuten nach Beginn des Bootvorgangs
-* <tt>OnUnitActiveSec=5min</tt> - weitere Ausführungen jeweils 5 Minuten, nachdem die Service Unit zu letzten Mal gestartet wurde
+* OnUnitActiveSec=5min - weitere Ausführungen jeweils 5 Minuten, nachdem die Service Unit zu letzten Mal gestartet wurde
 === Dateien ===
-{| class="wikitable options"
+{| class="wikitable options big"
 |-
 ! Datei !! Beschreibung