SYSTEMD.SYNTAX(7)

BEZEICHNUNG
systemd.syntax - Allgemeine Syntax von Systemd-Konfigurationsdateien

EINLEITUNG

Diese Seite beschreibt die grundlegenden Prinzipien von durch systemd(1) und verwandten Programmen benutzten Konfigurationsdateien für:

    • Systemd Unit-Dateien, siehe systemd.unit(5), systemd.service(5), systemd.socket(5), systemd.device(5), systemd.mount(5), systemd.automount(5), systemd.swap(5), systemd.target(5), systemd.path(5), systemd.timer(5), systemd.slice(5), systemd.scope(5)

    • Daemon-Konfigurationsdateien, siehe systemd-system.conf(5), systemd-user.conf(5), logind.conf(5), journald.conf(5), journal-remote.conf(5), journal-upload.conf(5), systemd-sleep.conf(5), timesyncd.conf(5)

Die Syntax ist durch die XDG Desktop Eintrag-Spezifikation[1] für .desktop-Dateien inspiriert, die wiederum durch Microsoft Windows .ini-Dateien inspiriert wurden.

Jede Datei ist eine reine Textdatei und in Abschnitte gegliedert, mit Konfigurationseinträgen der Art Schlüssel=Wert. Leerraum unmittelbar vor oder nach dem »=« wird ignoriert. Leere Zeilen und solche, die mit »#« oder »;« beginnen, werden ignoriert, was zum Kommentieren verwandt werden kann.

Zeilen, die in einem Rückwärtsschrägstrich enden, werden mit der nachfolgenden Zeile beim Lesen verbunden und der Rückwärtsschrägstrich wird durch ein Leerzeichen ersetzt. Dies kann zum Umbruch langer Zeilen verwandt werden. Die maximale Zeilenlänge ist sehr groß (derzeit 1 MB), aber es wird empfohlen, so lange Zeilen zu vermeiden und mehrere Anweisungen, Variablenersetzung oder andere geeignete Mechanismen für den vorgegebenen Dateityp zu verwenden. Wenn eine Kommentarzeile oder -zeilen einer auf einen Rückwärtsschrägstrich endenden Zeile folgt, wird der Kommentarblock ignoriert, so dass die fortgesetzte Zeile mit dem verbunden wird, was nach dem Kommentarblock folgt.

Beispiel 1.

    [Abschnitt A]
    Schlüssel1=Wert 1
    Schlüssel2=Wert 2
    # ein Kommentar
    [Abschnitt B]
    Einstellung="etwas" "etwas anderes" "…"
    Schlüssel2=Wert 2 \
               Wert 2 fortgesetzt
    [Abschnitt C]
    Schlüssel3=Wert 2\
    # diese Zeile wird ignoriert
    ; diese Zeile wird auch ignoriert
               Wert 2 forgesetzt

In Konfigurationsdateien verwandte logische Argumente können in verschiedenen Formaten geschrieben werden. Für positive Einstellungen sind die Zeichenketten 1, yes, true und on äquivalent. Für negative Einstellungen sind die Zeichenketten 0, no, false und off äquivalent.

In Konfigurationsdateien kodierte Zeitdauerwerte können in verschiedenen Formaten geschrieben werden. Falls ihnen eine Zeiteinheit (auf Englisch) angehängt wird, wird diese berücksichtigt. Eine Zusammenfügung mehrerer Werte mit Einheiten wird unterstützt, in diesem Fall werden die Werte aufaddiert. Beispiel: »50« bezieht sich auf 50 Sekunden; »2min 200ms« bezieht sich auf 2 Minuten und 200 Millisekunden; d. h. 120200 ms. Die folgenden Zeiteinheiten werden verstanden: »s«, »min«, »h«, »d«, »w«, »ms«, »us«. Für Details siehe systemd.time(7).

Verschiedene Einstellungen dürfen mehr als einmal festgelegt werden. In diesem Fall hängt die Interpretation von der Einstellung ab. Oft bilden mehrere Einstellungen eine Liste und das Setzen eines leeren Werts setzt die Einstellung »zurück«, was bedeutet, dass vorherige Zuweisungen ignoriert werden. Wenn dies erlaubt ist, wird es in der Beschreibung der Einstellung erwähnt. Beachten Sie, dass mehrfache Zuweisungen zu dem gleichen Wert dazu führt, dass die Datei inkompatibel zu Auswertprogrammen für das »XDG .desktop«-Format wird.

SIEHE AUCH

systemd.time(7)

ANMERKUNGEN

1.  XDG Desktop-Eintrag-Spezifikation
    http://standards.freedesktop.org/desktop-entry-spec/latest/

Ü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>.