BEZEICHNUNG

       systemd.environment-generator - Systemd-Umgebungsdatei-Generatoren

ÜBERSICHT

       /lib/systemd/system-environment-generators/ein-Generator

       /usr/lib/systemd/user-environment-generators/ein-Generator

       /run/systemd/system-environment-generators/*
       /etc/systemd/system-environment-generators/*
       /usr/local/lib/systemd/system-environment-generators/*
       /lib/systemd/system-environment-generators/*

       /run/systemd/user-environment-generators/*
       /etc/systemd/user-environment-generators/*
       /usr/local/lib/systemd/user-environment-generators/*
       /usr/lib/systemd/user-environment-generators/*

BESCHREIBUNG

       Generatoren sind kleine Programme, die sich in /lib/systemd/system-environment-generators/
       und anderen oben aufgeführten Verzeichnissen befinden. systemd(1) wird diese Programme
       sehr früh beim Hochfahren jedes Verwalters und zum Zeitpunkt des Neuladens der
       Konfiguration ausführen, bevor die in systemd.generator(7) beschriebenen Generatoren
       ausgeführt werden und bevor irgendeine Unit gestartet wird. Umgebungsgeneratoren können
       die Umgebung, die der Verwalter an Dienste und andere Prozesse exportiert, außer Kraft
       setzen.

       Generatoren werden aus einer Gruppe von Pfaden, die während der Compilierung bestimmt
       werden, wie diese oben aufgeführt sind, geladen. System- und Benutzerumgebungsgeneratoren
       werden aus Verzeichnissen geladen, deren Namen in system-environment-generators/ bzw.
       user-environment-generators/ enden. Generatoren, die in früher aufgeführten Verzeichnissen
       gefunden werden, setzen diejenigen außer Kraft, die mit dem gleichen Namen in
       Verzeichnissen weiter hinten in der Liste sind. Ein Symlink auf /dev/null oder eine leere
       Datei kann zur Ausmaskierung eines Generators verwandt werden, wodurch dessen Ausführung
       verhindert wird. Bitte beachten Sie, dass die Reihenfolge der zwei Verzeichnisse mit der
       höchsten Priorität in Hinblick auf den Unit-Ladepfad umgedreht ist und Generatoren in /run
       solche in /etc außer Kraft setzen.

       Nach der Installation neuer Generatoren oder der Aktualisierung ihrer Konfiguration kann
       systemctl daemon-reload ausgeführt werden. Dies wird alle Generatoren erneut ausführen und
       ihre Umgebungskonfiguration aktualisieren. Sie wird für alle nachfolgend gestarteten
       Dienste verwandt.

       Umgebungsdateigeneratoren werden ähnlich wie die in systemd.generator(7) beschriebenen
       Unit-Dateigeneratoren ausgeführt, mit den folgenden Unterschieden:

       •   Generatoren werden der Reihe nach in der alphanumerischen Reihenfolge ihrer finalen
           Komponenten ihres Namens ausgeführt. Die Ausgabe jedes Generators wird sofort
           ausgewertet und zur Aktualisierung der Umgebung für Generatoren, die danach ausgeführt
           werden, verwandt. Daher können spätere Generatoren die Ausgabe von früheren
           Generatoren verwenden und/oder verändern.

       •   Generatoren werden von jeder Verwalterinstanz ausgeführt, ihre Ausgabe kann für jeden
           Benutzer anders sein.

       Es wird empfohlen, Generatorennamen mit Zahlen zu beginnen, um ihre Ordnung zu
       vereinfachen.

BEISPIELE

       Beispiel 1. Ein einfacher Generator, der eine Umgebungsvariable erweitert, falls ein
       Verzeichnis im Dateisystem existiert

           # 50-xdg-data-dirs.sh

           #!/bin/bash

           # setzt den Vorgabewert
           XDG_DATA_DIRS="${XDG_DATA_DIRS:-/usr/local/share/:/usr/share}"

           # fügt ein Verzeichnis hinzu, falls es existiert
           if [[ -d /opt/foo/share ]]; then
               XDG_DATA_DIRS=/opt/foo/share:${XDG_DATA_DIRS}
           fi

           # schreibt unsere Ausgabe
           echo XDG_DATA_DIRS=$XDG_DATA_DIRS

       Beispiel 2. Ein komplizierterer Generator, der bestehende Konfiguration liest und eine
       Variable verändert

           # 90-rearrange-path.py

           #!/usr/bin/env python3

           """

           Konzept für einen beispielhaften Systemd-Umgebungsgenerator, der sicherstellt,
           dass bin-Verzeichnisse immer nach den passenden sbin-Verzeichnissen im Pfad
           sind.
           (Ändert /sbin:/bin:/foo/bar in /bin:/sbin:/foo/bar.)

           Dieser Generator zeigt, wie die möglicherweise von vorhergehenden Generatoren
           erstellte Konfiguration außer Kraft gesetzt wird. In Bash-Code wäre es
           einfacher, wir haben es aber in Python geschrieben, um zu zeigen, dass das
           möglich ist und als Vorlage für noch interessantere Generatoren.

           """

           import os
           import pathlib

           def rearrange_bin_sbin(path):
               """Sicherstellen, dass alle Verzeichnispaare .../bin, .../sbin in dieser Reihenfolge sind

               >>> rearrange_bin_sbin('/bin:/sbin:/usr/sbin:/usr/bin')
               '/bin:/sbin:/usr/bin:/usr/sbin'
               """
               items = [pathlib.Path(p) for p in path.split(':')]
               for i in range(len(items)):
                   if 'sbin' in items[i].parts:
                       ind = items[i].parts.index('sbin')
                       bin = pathlib.Path(*items[i].parts[:ind], 'bin', *items[i].parts[ind+1:])
                       if bin in items[i+1:]:
                           j = i + 1 + items[i+1:].index(bin)
                           items[i], items[j] = items[j], items[i]
               return ':'.join(p.as_posix() for p in items)

           if __name__ == '__main__':
               path = os.environ['PATH'] # Dies sollte immer gesetzt sein .
                                         # Falls nicht, stürzen wir einfach ab, wir sind auch i.O..
               new = rearrange_bin_sbin(path)
               if new != path:
                   print('PATH={}'.format(new))

       Beispiel 3. Fehlersuche in einem Generator

           SYSTEMD_LOG_LEVEL=debug VAR_A=etwas VAR_B="etwas anderes" \
           /lib/systemd/system-environment-generators/pfad-zum-generator

SIEHE AUCH

       systemd-environment-d-generator(8), systemd.generator(7), systemd(1), systemctl(1)

Ü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 <debian-l10n-german@lists.debian.org>.