Provided by: manpages-de_4.23.1-1_all 
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 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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 ⟨debian-l10n-german@lists.debian.org⟩.