table of contents
- bookworm 4.18.1-1
- bookworm-backports 4.24.0-2~bpo12+1
- testing 4.24.0-2
- unstable 4.24.0-2
SYSTEMD.PATH(5) | systemd.path | SYSTEMD.PATH(5) |
BEZEICHNUNG¶
systemd.path - Pfad-Unit-Konfiguration
ÜBERSICHT¶
Pfad.path
BESCHREIBUNG¶
Eine Unit-Konfigurationsdatei, deren Namen in ».path« endet, kodiert Informationen über einen durch Systemd überwachten Pfad, für Pfad-basierte Aktivierung.
Diese Handbuchseite führt die für diesen Unit-Typ spezifischen Konfigurationsoptionen auf. Siehe systemd.unit(5) für die gemeinsamen Optionen aller Unit-Konfigurationsdateien. Die gemeinsamen Konfigurationseinträge werden in den generischen Abschnitten »[Unit]« und »[Install]« konfiguriert. Die Pfad-spezifischen Konfigurationsoptionen werden in dem Abschnitt »[Path]« konfiguriert.
Für jede Pfaddatei muss eine passende Unit-Datei existieren, welche die bei Änderungen von Pfaden zu aktivierende Unit beschreibt. Standardmäßig wird ein Dienst mit dem gleichen Namen (außer der Endung) wie der Pfad aktiviert. Beispiel: Eine Pfad-Datei foo.path aktiviert einen passenden Dienst foo.service. Die zu aktivierende Unit kann mit Unit= (siehe unten) gesteuert werden.
Intern verwenden Pfad-Units das inotify(7)-API, um Dateisysteme zu überwachen. Daher unterliegen sie den gleichen Beschränkungen wie Inotify und können beispielsweise keine Dateien oder Verzeichnisse überwachen, die von anderen Maschinen auf fernen NFS-Dateisystemen geändert werden.
Wenn eine Dienste-Unit ausgelöst wird, weil sich eine Pfad-Unit beendet (unabhängig davon, ob sie sich erfolgreich beendete oder fehlschlug), werden überwachte Pfade sofort erneut überprüft und der Dienst entsprechend neugestartet. Als Schutz gegen Dauerschleifen in diesem Auslöse-/Startzyklus wird eine Startratenbegrenzung für diese Dienste-Unit erzwungen, siehe StartLimitIntervalSec= und StartLimitBurst= in systemd.unit(5). Anders als andere Dienstefehlschläge, wird die Fehlerbedingung, dass die Startratenbegrenzung erreicht wurde, von der Dienste-Unit zu der Pfad-Unit weitergeleitet und führt dazu, dass auch die Pfad-Unit fehlschlägt und damit die Schleife beendet wird.
AUTOMATISCHE ABHÄNGIGKEITEN¶
Implizite Abhängigkeiten¶
Die folgenden Abhängigkeiten werden implizit hinzugefügt:
Standardabhängigkeiten¶
Die folgenden Abhängigkeiten werden hinzugefügt, es sei denn, DefaultDependencies=no ist gesetzt:
OPTIONEN¶
Pfad-Unit-Dateien können Abschnitte [Unit] und [Install] enthalten, die in systemd.unit(5) beschrieben sind.
Pfad-Unit-Dateien müssen einen Abschnitt [Path] enthalten, der Informationen über den oder die überwachten Pfad(e) transportiert. Die für den Abschnitt [Path] von Pfad-Units speziellen Optionen sind:
PathExists=, PathExistsGlob=, PathChanged=, PathModified=, DirectoryNotEmpty=
Die Argumente dieser Anweisungen müssen absolute Dateisystempfade sein.
Mehrere Verzeichnisse des gleichen Typs oder unterschiedlicher Typen können kombiniert werden, um mehrere Pfade zu beobachten. Falls einer der Optionen die leere Zeichenkette zugeordnet wird, wird die Liste der zu beobachtenden Pfade zurückgesetzt und jede vorherige Zuweisung von diesen Optionen wird keinen Effekt zeigen.
Falls zum Zeitpunkt der Aktivierung der Unit ein Pfad bereits existiert (im Falle von PathExists= und PathExistsGlob=) oder ein Verzeichnis bereits nicht leer ist (im Falle von DirectoryNotEmpty=), dann wird die konfigurierte Unit auch sofort aktiviert. Für PathChanged= und PathModified= gilt etwas ähnliches nicht.
Falls der Pfad selbst oder eines der enthaltenen Verzeichnisse nicht zugreifbar ist, wird systemd auf Rechteänderungen prüfen und bemerken, dass die Bedingungen erfüllt sind, wenn die Berechtigungen es erlauben.
Unit=
MakeDirectory=
DirectoryMode=
TriggerLimitIntervalSec=, TriggerLimitBurst=
Lesen Sie systemd.unit(5), systemd.exec(5) und systemd.kill(5) für weitere Einstellungen.
SIEHE AUCH¶
Für die ausgelösten Units werden Umgebungsvariablen mit Details über den Trigger gesetzt. Siehe den Abschnitt »Vom Diensteverwalter gesetzte oder ausgebreitete Umgebungsvariablen« in systemd.exec(5) für weitere Details.
systemd(1), systemctl(1), systemd.unit(5), systemd.service(5), inotify(7), systemd.directives(7)
ÜBERSETZUNG¶
Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.
Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.
systemd 254 |