Systemd/Timers: Unterschied zwischen den Versionen

Aus wiki.archlinux.de
Zur Navigation springen Zur Suche springen
 
(27 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{inuse|[[Benutzer:Tuxnix|Tuxnix]] ([[Benutzer Diskussion:Tuxnix|Diskussion]])}}
 
[[Kategorie:Systemverwaltung]]
 
[[Kategorie:Services]]
 
 
[[en:Systemd/Timers]]
 
[[ja:Systemd/タイマー]]
 
[[ru:Systemd/Timers]]
 
 
 
{{righttoc}}
 
{{righttoc}}
Timer bieten die Möglichkeit Aufgaben zeitlich zu steuern. Die Timer-Unit bestehen aus einer {{ic|.timer}} und einer {{ic|.service}} Datei.
+
Timer bieten die Möglichkeit Aufgaben zeitlich zu steuern. Die Timer-Unit besteht aus einer {{ic|.timer}} Datei die eine {{ic|.service}} Datei ansteuert.
Sie untersteht [[systemd]] und muss mit dem systemctl Befehl aktiviert werden. Eine Alternative hierzu bietet [[cron]].
+
Timer unterstehen [[systemd]] und müssen mit dem systemctl Befehl aktiviert werden. Eine Alternative hierzu bietet [[cron]].
  
 
== Beispiel ==
 
== Beispiel ==
  
 
=== Die {{ic|.timer}} Datei ===
 
=== Die {{ic|.timer}} Datei ===
  # Datei /usr/lib/systemd/system/foo.timer
+
  <nowiki># Datei /etc/systemd/system/beispiel.timer
[Unit]
+
 
Description=foo
+
[Unit]
[Timer]
+
Description=Beispielaktion nach 1St 30Min
OnBootSec=1h
+
 
OnUnitInactiveSec=1d
+
[Timer]
[Install]
+
OnBootSec=1h 30m
WantedBy=basic.target
+
 
 +
[Install]
 +
WantedBy=basic.target</nowiki>
  
 
=== Die {{ic|.service}} Datei ===
 
=== Die {{ic|.service}} Datei ===
  # Datei /usr/lib/systemd/system/foo.service
+
  <nowiki># Datei /etc/systemd/system/beispiel.service
[Unit]
+
 
Description=foo
+
[Unit]
[Service]
+
Description=Beispiel Service
ExecStart=/usr/bin/foo
+
 
 +
[Service]
 +
ExecStart=/home/<user>/beispiel.sh</nowiki>
 +
 
 +
Dieses Beispiel stellt eine Minimalvariante der Dateien dar. Weiteres siehe [[Systemd/Timers#Optionen]].
 +
 
 
Als [Service] kann ein Befehl oder ein ausführbares Script genutzt werden.
 
Als [Service] kann ein Befehl oder ein ausführbares Script genutzt werden.
Service- und Timerdatei werden in /usr/lib/systemd/system/ abgelegt und müssen vor dem . (Punkt) den gleichen Namen tragen.
+
 
 +
Service- und Timerdatei werden mit root Rechten in /etc/systemd/system/ abgelegt und müssen vor dem . (Punkt) den gleichen Namen tragen.
  
 
=== De-/Aktivierung ===
 
=== De-/Aktivierung ===
  systemctl enable --now foo.timer
+
  systemctl enable --now beispiel.timer
 +
(Bei der ersten Initialisierung legt das System automatisch einen symlink /etc/systemd/system/basic.target.wants/ → /etc/systemd/system/ der {{ic|.timer}} Datei an.)
 +
 
 
Mit ''enable --now'' startet der Timer unverzüglich und permanent, sodass er auch nach einem Neustart aktiv ist.
 
Mit ''enable --now'' startet der Timer unverzüglich und permanent, sodass er auch nach einem Neustart aktiv ist.
Ohne ''--now'' werden ''enable, disable'' oder ''reenable'' erst nach einem reboot wirksam.
 
''start und stop'' hingegen, haben lediglich Auswirkungen auf die laufende Sitzung.
 
  
  systemctl reenable --now foo.timer  
+
Ohne ''--now'' werden ''enable oder disable'' erst nach einem reboot wirksam.
Genügt damit eine nachträgliche Veränderung der Timer-Unit wirksam wird.
+
 
 +
Ein ''start oder stop'' wirkt sich nur auf die laufende Sitzung aus.
 +
 
 +
  systemctl reenable --now beispiel.timer
 +
Genügt damit eine nachträgliche Veränderung der Timer-Unit sofort wirksam wird.
  
 
=== Management ===
 
=== Management ===
 
  systemctl list-timers --all
 
  systemctl list-timers --all
Listet alle Timer auf. Sollen nur die aktiven Timer angezeigt werden genügt ein ''systemctl list-timers''
+
Listet alle Timer auf. Sollen nur die aktiven Timer angezeigt werden genügt ein ''systemctl list-timers''.
 +
 
 +
 
 +
Die folgenden Befehle können beim Debuggen helfen:
 +
systemctl status beispiel.timer
 +
 
 +
journalctl -xe
 +
 
 +
== Optionen ==
 +
Die folgende Auflistung der einzelnen Optionen für die Sektionen der {{ic|.timer}} und {{ic|.service}} Dateien will lediglich einen Überblick bieten.
 +
 
 +
Für Details wird auf die jeweilige ''man page'' verwiesen.
 +
 
 +
Nur die '''fettgedruckten Optionen sind Pflichtangaben ''' der betreffenden Sektion.
 +
 
 +
=== Die [Unit] Sektion ===
 +
* '''Description=''' #Hier muss die Einheit beschrieben werden. Die Formulierung ist frei. Auch darf sie in der {{ic|.timer}} und {{ic|.service}} Datei unterschiedlich sein. Kurze, aussagefähige Beschreibungen sind hierbei vorzuziehen.
 +
* Documentation= #Eine URL kann hier angegeben werden.
 +
* Requires=, Requisite= #Weitere Units können hier angegeben werden.
 +
* Wants= #ein etwas weicheres Requires=
 +
* BindsTo= #Auch hier wird eine Unit angegeben. Fällt der service aus, weil z.B. ein device entfernt wurde, wird die Timer-Unit an der Ausführung gehindert.
 +
* PartOf= #beim Ausfall eines service stoppt die timer-unit. Jedoch ohne Auswirkungen auf die hier aufgeführten services. 
 +
* Conflicts=
 +
* Before=, After= #legt die Start Reihenfolge von services fest.
 +
* OnFailure= #Ersatz-Units die bei Ausfall genutzt werden sollen.
 +
* PropagatesReloadTo=, ReloadPropagatedFrom= #ähndelt OnFailure=
 +
* JoinsNamespaceOf= #Nur wichtig wenn PrivateNetwork= oder PrivateTmp= eingesetzt wird.
 +
* RequiresMountsFor= #Überprüft ob devices auch gemountet sind.
 +
* OnFailureJobMode=fail, replace (default), replace-irreversibly, isolate, flush, ignore-dependencies, ignore-requirements #legt das Verhalten für OnFailure= fest.         
 +
* IgnoreOnIsolate=true/false #default ist false. Bei true wird nicht mehr gestoppt bei Isolierung einer anderen Unit.
 +
* StopWhenUnneeded=true/false #default ist false. Steht im Zusammenhang mit Requires=. Bei true werden nicht mehr benötigte units deaktiviert.
 +
* RefuseManualStart=true/false, RefuseManualStop=true/false #default ist false. Ein Sicherheitstool. bei true wird die die explizite User Eingabe verlangt, bevor Units de/aktiviert werden können.
 +
* AllowIsolate=true/false #default ist false. Sinnvoll um ähnlich der runlevels in SysV init Systemen um unbestimmte Systemzustände zu vermeiden.
 +
* DefaultDependencies=true/false #Default ist true und stellt sicher, dass das System komplett hochgelaufen ist bevor die timer-unit gestartet wird.
 +
* JobTimeoutSec=, JobTimeoutAction=, JobTimeoutRebootArgument= #stellt bei gestaffelten Jobs ein time-out zur Verfügung.
 +
* StartLimitIntervalSec=, StartLimitBurst= #Als default werden 5 Ausführungen eines service innerhalb von 10 Sekunden zugestanden. Dieses Limit kann hier den speziellen Anforderungen angepasst werden.
 +
* StartLimitAction= #Ein Ersatzservice kann bestimmt werden falls das vereinbarte StartLimitIntervalSec=, StartLimitBurst= überschritten wird. 
 +
* RebootArgument= #Optionales reboot.
 +
* ConditionArchitecture=, ConditionVirtualization=, ConditionHost=, ConditionKernelCommandLine=, ConditionSecurity=, ConditionCapability=, ConditionACPower=, ConditionNeedsUpdate=, ConditionFirstBoot=, ConditionPathExists=, ConditionPathExistsGlob=, ConditionPathIsDirectory=, ConditionPathIsSymbolicLink=, ConditionPathIsMountPoint=, ConditionPathIsReadWrite=, ConditionDirectoryNotEmpty=, ConditionFileNotEmpty=, ConditionFileIsExecutable= # Vorbedingung für die Ausführung der Unit.
 +
* AssertArchitecture=, AssertVirtualization=, AssertHost=, AssertKernelCommandLine=, AssertSecurity=, AssertCapability=, AssertACPower=, AssertNeedsUpdate=, AssertFirstBoot=, AssertPathExists=, AssertPathExistsGlob=, AssertPathIsDirectory=, AssertPathIsSymbolicLink=, AssertPathIsMountPoint=, AssertPathIsReadWrite=, AssertDirectoryNotEmpty=, AssertFileNotEmpty=, AssertFileIsExecutable= # Wie Condition...allerdings incl. ''logged loudly'' bei failure.
 +
* SourcePath= # Überprüft das Vorhandensein einer Datei.
 +
 +
Genauere Auskunft gibt: {{ic|man systemd.unit}}
 +
 
 +
=== Die [Timer] Sektion ===
 +
Es können hier mehrere Zeitangaben gemacht werden. Mindestens '''eine Zeitangabe muss''' es in [Timer] geben.
 +
 
 +
==== Kalendarische Zeitangaben ====
 +
* OnCalendar= #Kalendarische Zeitangabe
 +
 
 +
===== Absolute Zeitangaben =====
 +
 
 +
OnCalendar=Thu,Fri 2012-*-1..5 11:12:13
 +
 
 +
Das obige Beispiel besagt: Um 11:12:13 Uhr, zwischen einschl. dem 1. und 5. Tag, aller Monate, des Jahres 2012, jedoch ausschließlich nur an Donnerstagen und Freitagen.
 +
 
 +
Die Angabe eines Wochentags erfolgt in Englisch. Sie ist optional.
 +
Jede Rubrik kann mit "," oder ".." versehen werden oder durch "*" ersetzt werden.
 +
 
 +
===== Periodische Zeitangaben =====
  
== Details ==
+
OnCalendar=weekly
Nun zu den Kleinigkeiten innerhalb der {{ic|.timer}} und {{ic|.service}} Dateien und welche Angaben hier getätigt werden können.
 
  
=== [Unit] ===
+
Auch diese Werte sind möglich.
* Description= hier wird der Name der Timer-Unit angegeben. Dieser Name erscheint bei der Abfrage mit ''systemctl list-timers''.
+
minutely, hourly, daily, monthly, weekly, yearly, quarterly, semiannually
noch k.w.T.
 
  
=== [Timer] ===
+
Entsprechend den oberen Werten, kann auch diese Schreibweise genutzt werden.
 +
*-*-* *:*:00, *-*-* *:00:00, *-*-* 00:00:00, *-*-01 00:00:00, Mon *-*-* 00:00:00, *-01-01 00:00:00, *-01,04,07,10-01 00:00:00, *-01,07-01 00:00:00
  
==== relative Zeitangaben ====
+
==== Relative Zeitangaben ====
 
Sind abhängig von anderen Ereignissen
 
Sind abhängig von anderen Ereignissen
* OnActiveSec= Zeitspanne seit Aktivierung des Timers selbst
 
* OnBootSec= Zeitspanne seit dem Booten des Rechners
 
* OnStartupSec= Zeitspanne seit dem ersten Start von systemd
 
* OnUnitActiveSec= Zeitspanne seit dem letzten Start des Timers
 
* OnUnitInactiveSec= Zeitspanne seit Inaktivität der Timer-Unit
 
(Hier müssen teilweise noch treffendere Vormulierungen gefunden werden)
 
  
Folgende Einheiten können für die rel. Zeitangaben gewählt werden:
+
Beispiel:
 +
OnBootSec=2d 1h 30m
 +
 
 +
* OnActiveSec= #Zeitspanne seit Aktivierung der Timer-Unit.
 +
* OnBootSec= #Zeitspanne seit dem Booten des Rechners.
 +
* OnStartupSec= #Zeitspanne seit dem Start von systemd.
 +
* OnUnitActiveSec= #Zeitspanne seit der Timer den letzten Job ausgelöst hat.
 +
* OnUnitInactiveSec= #Zeitspanne der Inaktivität seit Beendigung des letzten Jobs.
 +
 
 +
Folgende Einheiten können für relative Zeitangaben gewählt werden:
 
  usec, us
 
  usec, us
 
  msec, ms
 
  msec, ms
Zeile 73: Zeile 138:
 
  months, month, M (definiert als 30.44 Tage)
 
  months, month, M (definiert als 30.44 Tage)
 
  years, year, y (definiert als 365.25 Tage)
 
  years, year, y (definiert als 365.25 Tage)
 +
Ohne Verwendung einer Einheit werden alle Angaben als Sekunden gewertet.
  
siehe auch ''man systemd.time''
+
==== Weitere Optionen in [Timer] ====
Ohne Verwendung einer Einheit werden alle Angaben als Sekunden gewertet.
+
* AccuracySec=  #Die Zeitspanne zum Ausführen beträgt als default 1 Minute. Durch Verwendung von AccuracySec kann diese Zeitspanne variiert werden.
 +
* RandomizedDelaySec= #Kann verwendet werden damit nicht mehrere Timer exakt zur gleichen Zeit loslegen. default ist 0.
 +
* Unit= #Als default ist dieser Wert identisch mit dem Suffix der {{ic|.timer}} Datei. Bei der Verwendung von Unit= muss auch eine Datei mit selbigen Namen erstellt werden. Eine Verschachtelung von Units ist hierdurch möglich. Siehe [http://blog.higgsboson.tk/2013/06/09/use-systemd-as-a-cron-replacement Higgsboson Blog] Reflector
 +
* Persistent=true  #bewirkt, dass ein versäumter Job beim nächsten Rechnerstart unverzüglich nachgeholt wird.
 +
* WakeSystem= #Weckt das System aus dem supend mode.
 +
* RemainAfterElapse=true/false #true hält den Timer aktiv, false beendet den Timer nach einmaliger Ausführung.
 +
 
 +
Weiteres dazu siehe {{ic|man systemd.time}}.
  
  
* RandomizedDelaySec= Kann verwendet werden damit nicht mehrere Timer gleichzeitig loslegen. default ist 0.
+
=== Die [Install] Sektion ===
 +
* Alias= #Aliasnamen der Unit. Wird nicht von jedem Type unterstützt.
 +
* '''WantedBy='''basic.target, bluetooth.target, getty.target, multi-user.target, printer.target, sockets.target #Bei der ersten Initialisierung der Timer-Unit wird ein symbolischen Link von /etc/systemd/system/basic.target.wants/ angelegt. Erst dann ist die Unit aktiv.
 +
* RequiredBy= #entspricht WantetBy=.
 +
* Also= #installiert oder deinstalliert andere Units bei Aktivierung dieser Unit.
 +
* DefaultInstance= #Regelt den expliziten Einsatz von Vorlage Unit Dateien.
  
==== absolute Zeitangaben ====
+
Näheres dazu siehe {{ic|man systemd.unit}} und {{ic|man systemd.special}}.
* OnCalendar= absolute Zeitangabe
 
* Persistent=true - bewirkt, dass ein versäumter Jobs beim nächsten Rechnerstart unverzüglich nachgeholt wird.
 
* AccuracySec= Die Zeitspanne zum Ausführen beträgt als default 1 Minute. Durch Verwendung von AccuracySec können kleinere Zeitspannen gewählt werden.
 
  
Die absolute Zeitangabe hat folgende Syntax:
+
=== Die [Service] Sektion ===
Thu,Fri 2012-*-1..5 11:12:13
 
  
Das obige Beispiel besagt: Um 11:12:13 Uhr, zwischen dem 1. und 5. Tag, aller Monate, des Jahres 2012, jedoch ausschließlich nur an Donnerstagen und Freitagen.
+
* Type=simple (default), forking, oneshot, dbus, notify, idle.
 +
** PIDFile= #In Zusammenhang mit Type=forking kann für den Fork eine PID hinterlegt werden.
 +
** BusName= #Bei Type=dbus kann hier der betreffende D-Bus Name vereinbart werden.
 +
** NotifyAccess= none (default), main, all. #Steuert den ''service status notification socket''.
 +
* '''ExecStart=''' #Angabe von einem oder mehrerer Befehle und deren Argumente oder eines ausführbaren Scripts. Die absolute Pfadangabe wird verlangt.
 +
** ExecStartPre=, ExecStartPost= #Hier aufgeführte Befehle werden vor bzw. nach ExecStart= ausgeführt.
 +
** ExecReload=# Wind genutzt um eine Rekonfiguration des Service zu veranlassen.
 +
** ExecStop= #Wird benötigt falls der Service zum Beenden spezielle Befehle braucht.
 +
*** ExecStopPost= #Ergänzt ExecStop=
 +
** RemainAfterExit= #no (default), yes hält den service aktiv.
 +
** PermissionsStartOnly= #Default ist false. True erlaubt unter ExecStart= Befehle mit anderen Benutzerrechten ausführen zu lassen als die Komandos bei ExecStartPre=, ExecStartPost=, ExecReload=, ExecStop=, und ExecStopPost=.
 +
* GuessMainPID= #Default ist yes. Wenn die PID nicht exakt bestimmt werden kann wird normalerweise versucht sie zu berechnen. Dies kann hier ausgeschaltet werden.
 +
* TimeoutSec=, TimeoutStartSec=, TimeoutStopSec= #Legt ein Timeout für den Service fest.
 +
* RuntimeMaxSec= #Begrenzt die Laufzeit eines Service. Default ist unbegrenzte Zeit.
 +
* WatchdogSec= #Überwacht den Service auf Aktivität.
 +
* Restart= no (default), on-success, on-failure, on-abnormal, on-watchdog, on-abort, always #Startet den Service erneut.
 +
** RestartSec= #wird nur für Restart= gebraucht
 +
* RootDirectoryStartOnly= #Default ist false. True erlaubt das root Verzeichnis selektiv für ExecStart= Befehle neu zu definieren.
 +
* Sockets= #Siehe {{ic|man systemd.socket}}
 +
** NonBlocking=  #Default ist false. Siehe Näheres {{ic|man systemd.socket}}
 +
* FailureAction= #Aktion nach Scheitern des Service. Default ist none.
 +
* FileDescriptorStoreMax= #Anzahl der Datei Descriptoren. Default ist 0.
 +
* USBFunctionDescriptors= #Betrifft USB-Sticks.
 +
* USBFunctionStrings= #Betrifft USB-Sticks.
  
Die Angabe eines Wochentags erfolgt in Englisch. Sie ist optional.
+
Näheres dazu siehe {{ic|man systemd.service}}.
Jede Rubrik kann mit "," oder ".." versehen werden oder durch "*" ersetzt werden.
 
  
Weiteres siehe ''man systemd.time''.
+
== MailTo ==
  
=== [Install] ===
+
Die Optionen zum Versenden von Mails beim Ausführen der Services wird bestens im englischen Wiki beschrieben: [https://wiki.archlinux.org/index.php/Systemd/Timers#MAILTO]
* WantedBy=basic.target
 
noch k.w.T.
 
  
=== [Service] ===
+
== Siehe auch ==
* Type=oneshot
+
* [[systemd]]
* Nice=19
+
* [[systemd/Eigener Service|Einen eigenen systemd-Service erstellen]]
* IOSchedulingClass=2
+
* [[Automatische Sicherung (Beispiel)]]
* IOSchedulingPriority=7
 
* Environment="ABRT_IGNORE_PYTHON=1"
 
* ExecStart= Angabe eines Befehls oder eines ausführbaren Scripts.
 
  
 
== Weblinks ==
 
== Weblinks ==
* [https://kofler.info/systemd-timer-als-cron-alternative/ Michael Kofler Blog] Anleitung
+
* [https://kofler.info/systemd-timer-als-cron-alternative/ Michael Kofler Blog] Anleitung und Beispiel {{sprache|de}}
* [https://fedoraproject.org/wiki/Features/SystemdCalendarTimers Fedora Project wiki page] on ''systemd'' calendar timers
+
* [http://www.techrapid.co.uk/2017/04/automatically-update-arch-linux-with-systemd.html Techrapid Update Archlinux With Systemd] {{sprache|de}} Hinweis: Autoupdates sind nur bedingt zu empfehlen!
* [https://wiki.gentoo.org/wiki/Systemd#Timer_services Gentoo wiki section] on ''systemd'' timer services
+
* [https://fedoraproject.org/wiki/Features/SystemdCalendarTimers Fedora Project wiki page] on ''systemd'' calendar timers {{sprache|en}}
* [https://www.freedesktop.org/software/systemd/man/systemd.timer.html freedesktop.org]Man page timer
+
* [https://wiki.gentoo.org/wiki/Systemd#Timer_services Gentoo wiki section] on ''systemd'' timer services {{sprache|en}}
 +
 
 +
[[Kategorie:Systemverwaltung]]
 +
[[Kategorie:Services]]
 +
 
 +
[[en:Systemd/Timers]]
 +
[[fr:Systemd/cron]]
 +
[[ja:Systemd/タイマー]]
 +
[[ru:Systemd/Timers]]

Aktuelle Version vom 21. April 2019, 09:55 Uhr

Timer bieten die Möglichkeit Aufgaben zeitlich zu steuern. Die Timer-Unit besteht aus einer .timer Datei die eine .service Datei ansteuert. Timer unterstehen systemd und müssen mit dem systemctl Befehl aktiviert werden. Eine Alternative hierzu bietet cron.

Beispiel

Die .timer Datei

# Datei /etc/systemd/system/beispiel.timer

[Unit]
Description=Beispielaktion nach 1St 30Min

[Timer]
OnBootSec=1h 30m

[Install]
WantedBy=basic.target

Die .service Datei

# Datei /etc/systemd/system/beispiel.service

[Unit]
Description=Beispiel Service

[Service]
ExecStart=/home/<user>/beispiel.sh

Dieses Beispiel stellt eine Minimalvariante der Dateien dar. Weiteres siehe Systemd/Timers#Optionen.

Als [Service] kann ein Befehl oder ein ausführbares Script genutzt werden.

Service- und Timerdatei werden mit root Rechten in /etc/systemd/system/ abgelegt und müssen vor dem . (Punkt) den gleichen Namen tragen.

De-/Aktivierung

systemctl enable --now beispiel.timer

(Bei der ersten Initialisierung legt das System automatisch einen symlink /etc/systemd/system/basic.target.wants/ → /etc/systemd/system/ der .timer Datei an.)

Mit enable --now startet der Timer unverzüglich und permanent, sodass er auch nach einem Neustart aktiv ist.

Ohne --now werden enable oder disable erst nach einem reboot wirksam.

Ein start oder stop wirkt sich nur auf die laufende Sitzung aus.

systemctl reenable --now beispiel.timer

Genügt damit eine nachträgliche Veränderung der Timer-Unit sofort wirksam wird.

Management

systemctl list-timers --all

Listet alle Timer auf. Sollen nur die aktiven Timer angezeigt werden genügt ein systemctl list-timers.


Die folgenden Befehle können beim Debuggen helfen:

systemctl status beispiel.timer
journalctl -xe

Optionen

Die folgende Auflistung der einzelnen Optionen für die Sektionen der .timer und .service Dateien will lediglich einen Überblick bieten.

Für Details wird auf die jeweilige man page verwiesen.

Nur die fettgedruckten Optionen sind Pflichtangaben der betreffenden Sektion.

Die [Unit] Sektion

  • Description= #Hier muss die Einheit beschrieben werden. Die Formulierung ist frei. Auch darf sie in der .timer und .service Datei unterschiedlich sein. Kurze, aussagefähige Beschreibungen sind hierbei vorzuziehen.
  • Documentation= #Eine URL kann hier angegeben werden.
  • Requires=, Requisite= #Weitere Units können hier angegeben werden.
  • Wants= #ein etwas weicheres Requires=
  • BindsTo= #Auch hier wird eine Unit angegeben. Fällt der service aus, weil z.B. ein device entfernt wurde, wird die Timer-Unit an der Ausführung gehindert.
  • PartOf= #beim Ausfall eines service stoppt die timer-unit. Jedoch ohne Auswirkungen auf die hier aufgeführten services.
  • Conflicts=
  • Before=, After= #legt die Start Reihenfolge von services fest.
  • OnFailure= #Ersatz-Units die bei Ausfall genutzt werden sollen.
  • PropagatesReloadTo=, ReloadPropagatedFrom= #ähndelt OnFailure=
  • JoinsNamespaceOf= #Nur wichtig wenn PrivateNetwork= oder PrivateTmp= eingesetzt wird.
  • RequiresMountsFor= #Überprüft ob devices auch gemountet sind.
  • OnFailureJobMode=fail, replace (default), replace-irreversibly, isolate, flush, ignore-dependencies, ignore-requirements #legt das Verhalten für OnFailure= fest.
  • IgnoreOnIsolate=true/false #default ist false. Bei true wird nicht mehr gestoppt bei Isolierung einer anderen Unit.
  • StopWhenUnneeded=true/false #default ist false. Steht im Zusammenhang mit Requires=. Bei true werden nicht mehr benötigte units deaktiviert.
  • RefuseManualStart=true/false, RefuseManualStop=true/false #default ist false. Ein Sicherheitstool. bei true wird die die explizite User Eingabe verlangt, bevor Units de/aktiviert werden können.
  • AllowIsolate=true/false #default ist false. Sinnvoll um ähnlich der runlevels in SysV init Systemen um unbestimmte Systemzustände zu vermeiden.
  • DefaultDependencies=true/false #Default ist true und stellt sicher, dass das System komplett hochgelaufen ist bevor die timer-unit gestartet wird.
  • JobTimeoutSec=, JobTimeoutAction=, JobTimeoutRebootArgument= #stellt bei gestaffelten Jobs ein time-out zur Verfügung.
  • StartLimitIntervalSec=, StartLimitBurst= #Als default werden 5 Ausführungen eines service innerhalb von 10 Sekunden zugestanden. Dieses Limit kann hier den speziellen Anforderungen angepasst werden.
  • StartLimitAction= #Ein Ersatzservice kann bestimmt werden falls das vereinbarte StartLimitIntervalSec=, StartLimitBurst= überschritten wird.
  • RebootArgument= #Optionales reboot.
  • ConditionArchitecture=, ConditionVirtualization=, ConditionHost=, ConditionKernelCommandLine=, ConditionSecurity=, ConditionCapability=, ConditionACPower=, ConditionNeedsUpdate=, ConditionFirstBoot=, ConditionPathExists=, ConditionPathExistsGlob=, ConditionPathIsDirectory=, ConditionPathIsSymbolicLink=, ConditionPathIsMountPoint=, ConditionPathIsReadWrite=, ConditionDirectoryNotEmpty=, ConditionFileNotEmpty=, ConditionFileIsExecutable= # Vorbedingung für die Ausführung der Unit.
  • AssertArchitecture=, AssertVirtualization=, AssertHost=, AssertKernelCommandLine=, AssertSecurity=, AssertCapability=, AssertACPower=, AssertNeedsUpdate=, AssertFirstBoot=, AssertPathExists=, AssertPathExistsGlob=, AssertPathIsDirectory=, AssertPathIsSymbolicLink=, AssertPathIsMountPoint=, AssertPathIsReadWrite=, AssertDirectoryNotEmpty=, AssertFileNotEmpty=, AssertFileIsExecutable= # Wie Condition...allerdings incl. logged loudly bei failure.
  • SourcePath= # Überprüft das Vorhandensein einer Datei.

Genauere Auskunft gibt: man systemd.unit

Die [Timer] Sektion

Es können hier mehrere Zeitangaben gemacht werden. Mindestens eine Zeitangabe muss es in [Timer] geben.

Kalendarische Zeitangaben

  • OnCalendar= #Kalendarische Zeitangabe
Absolute Zeitangaben
OnCalendar=Thu,Fri 2012-*-1..5 11:12:13

Das obige Beispiel besagt: Um 11:12:13 Uhr, zwischen einschl. dem 1. und 5. Tag, aller Monate, des Jahres 2012, jedoch ausschließlich nur an Donnerstagen und Freitagen.

Die Angabe eines Wochentags erfolgt in Englisch. Sie ist optional. Jede Rubrik kann mit "," oder ".." versehen werden oder durch "*" ersetzt werden.

Periodische Zeitangaben
OnCalendar=weekly

Auch diese Werte sind möglich.

minutely, hourly, daily, monthly, weekly, yearly, quarterly, semiannually

Entsprechend den oberen Werten, kann auch diese Schreibweise genutzt werden.

*-*-* *:*:00, *-*-* *:00:00, *-*-* 00:00:00, *-*-01 00:00:00, Mon *-*-* 00:00:00, *-01-01 00:00:00, *-01,04,07,10-01 00:00:00, *-01,07-01 00:00:00

Relative Zeitangaben

Sind abhängig von anderen Ereignissen

Beispiel:

OnBootSec=2d 1h 30m
  • OnActiveSec= #Zeitspanne seit Aktivierung der Timer-Unit.
  • OnBootSec= #Zeitspanne seit dem Booten des Rechners.
  • OnStartupSec= #Zeitspanne seit dem Start von systemd.
  • OnUnitActiveSec= #Zeitspanne seit der Timer den letzten Job ausgelöst hat.
  • OnUnitInactiveSec= #Zeitspanne der Inaktivität seit Beendigung des letzten Jobs.

Folgende Einheiten können für relative Zeitangaben gewählt werden:

usec, us
msec, ms
seconds, second, sec, s
minutes, minute, min, m
hours, hour, hr, h
days, day, d
weeks, week, w
months, month, M (definiert als 30.44 Tage)
years, year, y (definiert als 365.25 Tage)

Ohne Verwendung einer Einheit werden alle Angaben als Sekunden gewertet.

Weitere Optionen in [Timer]

  • AccuracySec= #Die Zeitspanne zum Ausführen beträgt als default 1 Minute. Durch Verwendung von AccuracySec kann diese Zeitspanne variiert werden.
  • RandomizedDelaySec= #Kann verwendet werden damit nicht mehrere Timer exakt zur gleichen Zeit loslegen. default ist 0.
  • Unit= #Als default ist dieser Wert identisch mit dem Suffix der .timer Datei. Bei der Verwendung von Unit= muss auch eine Datei mit selbigen Namen erstellt werden. Eine Verschachtelung von Units ist hierdurch möglich. Siehe Higgsboson Blog Reflector
  • Persistent=true #bewirkt, dass ein versäumter Job beim nächsten Rechnerstart unverzüglich nachgeholt wird.
  • WakeSystem= #Weckt das System aus dem supend mode.
  • RemainAfterElapse=true/false #true hält den Timer aktiv, false beendet den Timer nach einmaliger Ausführung.

Weiteres dazu siehe man systemd.time.


Die [Install] Sektion

  • Alias= #Aliasnamen der Unit. Wird nicht von jedem Type unterstützt.
  • WantedBy=basic.target, bluetooth.target, getty.target, multi-user.target, printer.target, sockets.target #Bei der ersten Initialisierung der Timer-Unit wird ein symbolischen Link von /etc/systemd/system/basic.target.wants/ angelegt. Erst dann ist die Unit aktiv.
  • RequiredBy= #entspricht WantetBy=.
  • Also= #installiert oder deinstalliert andere Units bei Aktivierung dieser Unit.
  • DefaultInstance= #Regelt den expliziten Einsatz von Vorlage Unit Dateien.

Näheres dazu siehe man systemd.unit und man systemd.special.

Die [Service] Sektion

  • Type=simple (default), forking, oneshot, dbus, notify, idle.
    • PIDFile= #In Zusammenhang mit Type=forking kann für den Fork eine PID hinterlegt werden.
    • BusName= #Bei Type=dbus kann hier der betreffende D-Bus Name vereinbart werden.
    • NotifyAccess= none (default), main, all. #Steuert den service status notification socket.
  • ExecStart= #Angabe von einem oder mehrerer Befehle und deren Argumente oder eines ausführbaren Scripts. Die absolute Pfadangabe wird verlangt.
    • ExecStartPre=, ExecStartPost= #Hier aufgeführte Befehle werden vor bzw. nach ExecStart= ausgeführt.
    • ExecReload=# Wind genutzt um eine Rekonfiguration des Service zu veranlassen.
    • ExecStop= #Wird benötigt falls der Service zum Beenden spezielle Befehle braucht.
      • ExecStopPost= #Ergänzt ExecStop=
    • RemainAfterExit= #no (default), yes hält den service aktiv.
    • PermissionsStartOnly= #Default ist false. True erlaubt unter ExecStart= Befehle mit anderen Benutzerrechten ausführen zu lassen als die Komandos bei ExecStartPre=, ExecStartPost=, ExecReload=, ExecStop=, und ExecStopPost=.
  • GuessMainPID= #Default ist yes. Wenn die PID nicht exakt bestimmt werden kann wird normalerweise versucht sie zu berechnen. Dies kann hier ausgeschaltet werden.
  • TimeoutSec=, TimeoutStartSec=, TimeoutStopSec= #Legt ein Timeout für den Service fest.
  • RuntimeMaxSec= #Begrenzt die Laufzeit eines Service. Default ist unbegrenzte Zeit.
  • WatchdogSec= #Überwacht den Service auf Aktivität.
  • Restart= no (default), on-success, on-failure, on-abnormal, on-watchdog, on-abort, always #Startet den Service erneut.
    • RestartSec= #wird nur für Restart= gebraucht
  • RootDirectoryStartOnly= #Default ist false. True erlaubt das root Verzeichnis selektiv für ExecStart= Befehle neu zu definieren.
  • Sockets= #Siehe man systemd.socket
    • NonBlocking= #Default ist false. Siehe Näheres man systemd.socket
  • FailureAction= #Aktion nach Scheitern des Service. Default ist none.
  • FileDescriptorStoreMax= #Anzahl der Datei Descriptoren. Default ist 0.
  • USBFunctionDescriptors= #Betrifft USB-Sticks.
  • USBFunctionStrings= #Betrifft USB-Sticks.

Näheres dazu siehe man systemd.service.

MailTo

Die Optionen zum Versenden von Mails beim Ausführen der Services wird bestens im englischen Wiki beschrieben: [1]

Siehe auch

Weblinks