Scroll to navigation

SYSTEMD.V(7) systemd.v SYSTEMD.V(7)

BEZEICHNUNG

systemd.v - Verzeichnis mit versionierten Ressourcen

BESCHREIBUNG

An verschiedenen Stellen akzeptieren Systemd-Komponenten Pfade, deren abschließende Komponenten die Endung ».v/« haben und auf ein Verzeichnis zeigen. Diese Komponenten werden dann automatisch nach geeigneten Dateien innerhalb dieser Verzeichnisse suchen, einen Versionsvergleich durchführen und die neueste gefundene Datei (gemäß Version) öffnen. Verfügbar seit Version v256. Insbesondere werden zwei Ausdrücke unterstützt:

•Wird nach Dateien mit Endung .ENDUNG geschaut und ein Pfad …PFAD/NAME.ENDUNG.v/ ist angegeben worden, dann werden alle Dateien in …PFAD/NAME.ENDUNG.v/NAME_*.ENDUNG aufgezählt, gefiltert, sortiert und es wird die neueste Datei verwandt. Der primäre Sortierschlüssel ist der variable Anteil, hier mit dem Platzhalter »*« gekennzeichnet.

•Wenn ein Pfad …PFAD.v/NAME___.ENDUNG angegeben ist (d.h. die vorletzte Komponente des Pfades endet auf ».v« und die abschließende Komponente enthält einen dreifachen Unterstrich), dann werden alle Dateien in …PFAD.v/NAME_*.ENDUNG aufgezählt, gefiltert, sortiert und es wird die neueste Datei verwandt (wieder über den variablen Anteil, hier mit dem Platzhalter »*« gekennzeichnet).

Um dies in einem Beispiel vorzustellen, betrachten Sie ein Verzeichnis /var/lib/machines/mymachine.raw.v/, das mit drei Dateien bestückt ist:

•mymachine_7.5.13.raw

•mymachine_7.5.14.raw

•mymachine_7.6.0.raw

Rufen Sie ein Werkzeug wie systemd-nspawn(1) mit einer Befehlszeile der folgenden Art auf:

# systemd-nspawn --image=/var/lib/machines/mymachine.raw.v --boot

Dies würde dann automatisch zum Äquivalent von Folgendem aufgelöst:

# systemd-nspawn --image=/var/lib/machines/mymachine.raw.v/mymachine_7.6.0.raw --boot

Ein Großteil der Funktionalität von Systemd erwartet, dass ein Pfad zu einem Plattenabbild oder einer Betriebssystemhierarchie den Mechanismus der versionierten ».v/«-Verzeichnisse unterstützt, beispielsweise systemd-nspawn(1), systemd-dissect(1) oder die Einstellungen RootDirectory=/RootImage= von Dienstedateien (siehe systemd.exec(5)).

Verwenden Sie das Werkzeug systemd-vpick(1), um ».v/«-Pfade auf der Befehlszeile aufzulösen, beispielsweise zur Verwendung in Shell-Skripten.

FILTERN UND SORTIEREN

Der variable Anteil der Dateinamen in ».v/«-Verzeichnissen wird primär mit einem Versionsvergleich, der die Versionsformatspezifikation[1] implementiert, gefiltert und verglichen. Allerdings gelten die folgenden zusätzlichen Regeln:

•Falls an den variablen Anteil eine oder zwei Ganzzahlwerte im Format +VERBLIEBEN oder +VERBLIEBEN-ERFOLGT angehängt sind (»verbliebene Versuche« und »erfolgte Versuche«), dann zeigen diese Anwendungsversuchszähler an. Die Idee besteht darin, dass jedesmal vor dem Versuch der Verwendung einer Datei dessen Zähler »verbliebene Versuche« heruntergezählt wird und der Zähler »erfolgte Versuche« erhöht wird (einfach durch Umbenennung der Datei). Wenn die Datei erfolgreich verwandt wird (das beispielsweise für ein Betriebssystemabbild bedeuten könnte, dass es erfolgreich gestartet wurde), werden die Zähler von dem Dateinamen entfernt, was anzeigt, dass die Datei für die korrekte Funktion validiert wurde. Dieser Mechanismus entspricht dem in Automatische Systemstartbeurteilung[2] definierten Systemstart-Beurteilungszählern. Jeder Dateiname ohne Systemstartzähler oder bei denen »verbliebene Versuche« nicht Null ist, wird vor Dateinamen sortiert, bei denen der Zähler »verbliebene Versuche« Null ist.

•Vor diesen Zählern (falls sie angegeben sind) kann ein optionaler CPU-Architekturkennzeichner im Dateinamen festgelegt werden (getrennt von der Version durch einen Unterstrich), wie dies im Architekturvokabular der Unit-Dateieinstellung ConditionArchitecture=, dokumentiert in systemd.unit(5), definiert ist. Dateien, deren Namen eine lokal nicht unterstützte Architektur anzeigen, werden herausgefiltert und nicht für den Versionsvergleich betrachtet.

•Der Rest des variablen Anteils ist die Versionszeichenkette.

Or in other words, the files in the ".v/" directories should follow one of these naming structures:

•NAME_VERSION.ENDUNG

•NAME_VERSION_ARCHITEKTUR.ENDUNG

•NAME_VERSION+LEFT.SUFFIX

•NAME_VERSION+LEFT-DONE.SUFFIX

•NAME_VERSION_ARCHITECTURE+LEFT.SUFFIX

•NAME_VERSION_ARCHITECTURE+LEFT-DONE.SUFFIX

BEISPIEL

Here's a more comprehensive example, further extending the one described above. Consider a directory /var/lib/machines/mymachine.raw.v/, which is populated with the following files:

•mymachine_7.5.13.raw

•mymachine_7.5.14_x86-64.raw

•mymachine_7.6.0_arm64.raw

•mymachine_7.7.0_x86-64+0-5.raw

Now invoke the following command on an x86-64 machine:

$ systemd-vpick --suffix=.raw /var/lib/machines/mymachine.raw.v/

This would resolve the specified path to /var/lib/machines/mymachine.raw.v/mymachine_7.5.14_x86-64.raw. Explanation: even though mymachine_7.7.0_x86-64+0-5.raw has the newest version, it is not preferred because its tries left counter is zero. And even though mymachine_7.6.0_arm64.raw has the second newest version it is also not considered, in this case because we operate on an x86_64 system and the image is intended for arm64 CPUs. Finally, the mymachine_7.5.13.raw image is not considered because it is older than mymachine_7.5.14_x86-64.raw.

SIEHE AUCH

systemd(1), systemd-vpick(1), systemd-nspawn(1), systemd-dissect(1), systemd.exec(5), systemd-sysupdate(1)

ANMERKUNGEN

1.
Versionsformatspezifikation
https://uapi-group.org/specifications/specs/version_format_specification/
2.
Automatische Systemstartbeurteilung
https://systemd.io/AUTOMATIC_BOOT_ASSESSMENT/

Ü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 256~rc3