.\" -*- coding: UTF-8 -*-
'\" t
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH SYSTEMD\-DISSECT 1 "" "systemd 255" systemd\-dissect
.ie  \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH BEZEICHNUNG
systemd\-dissect, mount.ddi \- Auffindbare Plattenabbilder (DDIs) analysieren
.SH ÜBERSICHT
.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fIIMAGE\fR\fR\ 'u
\fBsystemd\-dissect \fP\fB[OPTIONEN…]\fP\fB \fP\fIABBILD\fP
.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-mount\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\fB\ \fR\fB\fIPATH\fR\fR\ 'u
\fBsystemd\-dissect \fP\fB[OPTIONEN…]\fP\fB \fP\fB\-\-mount\fP\fB \fP\fIABBILD\fP\fB \fP\fIPFAD\fP
.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-umount\fR\fR\fB\ \fR\fB\fIPATH\fR\fR\ 'u
\fBsystemd\-dissect \fP\fB[OPTIONEN…]\fP\fB \fP\fB\-\-umount\fP\fB \fP\fIPFAD\fP
.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-attach\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\ 'u
\fBsystemd\-dissect \fP\fB[OPTIONEN…]\fP\fB \fP\fB\-\-attach\fP\fB \fP\fIABBILD\fP
.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-detach\fR\fR\fB\ \fR\fB\fIPATH\fR\fR\ 'u
\fBsystemd\-dissect \fP\fB[OPTIONEN…]\fP\fB \fP\fB\-\-detach\fP\fB \fP\fIPFAD\fP
.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-list\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\ 'u
\fBsystemd\-dissect \fP\fB[OPTIONEN…]\fP\fB \fP\fB\-\-list\fP\fB \fP\fIABBILD\fP
.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-mtree\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\ 'u
\fBsystemd\-dissect \fP\fB[OPTIONEN…]\fP\fB \fP\fB\-\-mtree\fP\fB \fP\fIABBILD\fP
.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-with\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\fB\ \fR\fB[\fICOMMAND\fR...]\fR\ 'u
\fBsystemd\-dissect \fP\fB[OPTIONEN…]\fP\fB \fP\fB\-\-with\fP\fB \fP\fIABBILD\fP\fB \fP\fB[\fP\fIBEFEHL\fP…]
.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-copy\-from\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\fB\ \fR\fB\fIPATH\fR\fR\fB\ \fR\fB[\fITARGET\fR]\fR\ 'u
\fBsystemd\-dissect \fP\fB[OPTIONEN…]\fP\fB \fP\fB\-\-copy\-from\fP\fB \fP\fIABBILD\fP\fB \fP\fIPFAD\fP\fB \fP\fB[\fP\fIZIEL\fP]
.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-copy\-to\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\fB\ \fR\fB[\fISOURCE\fR]\fR\fB\ \fR\fB\fIPATH\fR\fR\ 'u
\fBsystemd\-dissect \fP\fB[OPTIONEN…]\fP\fB \fP\fB\-\-copy\-to\fP\fB \fP\fIABBILD\fP\fB \fP\fB[\fP\fIQUELLE\fP]\fB \fP\fIPFAD\fP
.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-discover\fR\fR\ 'u
\fBsystemd\-dissect \fP\fB[OPTIONEN…]\fP\fB \fP\fB\-\-discover\fP
.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-validate\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\ 'u
\fBsystemd\-dissect \fP\fB[OPTIONEN…]\fP\fB \fP\fB\-\-validate\fP\fB \fP\fIABBILD\fP
.SH BESCHREIBUNG
.PP
\fBsystemd\-dissect\fP ist ein Werkzeug zur Untersuchung und zum Umgang mit
Dateisystem\-Betriebssystemabbildern, insbesondere auffindbaren
Plattenabbildern (DDIs)\&. Es unterstützt vier verschiedene Aktionen:
.sp
.RS 4
.ie  n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
Die Anzeige allgemeiner Betriebssystemabbildinformationen, einschließliche
der Daten aus \fBos\-release\fP(5) des Abbildes, der Maschinenkennung, der
Partitionsinformationen und weitere\&.
.RE
.sp
.RS 4
.ie  n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
Das Einhängen eines Betriebssystemabbildes in ein lokales Verzeichnis\&. In
diesem Modus wird es das Betriebssystemabbild zerlegen und die enthaltenen
Partitionen entsprechend ihrer Bestimmung in ein Verzeichnis und
möglicherweise Unterverzeichnisse einhängen\&.
.RE
.sp
.RS 4
.ie  n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
Das Aushängen eines Betriebssystemabbildes aus einem lokalen
Verzeichnis\&. In diesem Modus wird es rekursiv die eingehängten Partitionen
aushängen und das zugrundeliegende Loop\-Gerät entfernen, einschließlich
aller Partitions\-Untergeräte\&.
.RE
.sp
.RS 4
.ie  n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
Das Kopieren von Dateien in und aus dem Betriebssystemabbild\&.
.RE
.PP
Das Werkzeug kann auf drei Arten von Betriebssystemabbildern arbeiten:
.sp
.RS 4
.ie  n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
Betriebssystemplattenabbilder, die eine GPT\-Partitionstabellen\-Einhüllende
enthalten, wobei die Partitionen entsprechend der \m[blue]\fBSpezifikation für auffindbare Partitionen\fP\m[]\&\s-2\u[1]\d\s+2 markiert sind\&.
.RE
.sp
.RS 4
.ie  n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
Betriebssystemplattenabbilder, die nur ein einfaches Dateisystem ohne
umhüllende Partitionstabelle enthalten\&. (Dieses Dateisystem wird als
Wurzeldateisystem des Betriebssystems angenommen\&.)
.RE
.sp
.RS 4
.ie  n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
Betriebssystemabbilder, die eine GPT\- oder MBR\-Partitionstabelle mit nur
einer einzigen Partition enthalten\&. (Dieses Dateisystem wird als
Wurzeldateisystem des Betriebssystems angenommen\&.)
.RE
.PP
Betriebssystemabbilder können jede Art von Linux unterstützter Dateisysteme
verwenden\&. Zusätzlich können sie LUKS\-Plattenverschlüsselung verwenden und
Verity\-Integritätsinformationen enthalten\&. Beachten Sie, dass so geeignete
Betriebssystemabbilder mit dem Schalter \fB\-\-image=\fP von \fBsystemd\-nspawn\fP(1)
gestartet und als Wurzeldateisystem für Dienste, die die
Unit\-Dateieinstellung \fIRootImage=\fP verwenden, eingesetzt werden können,
siehe \fBsystemd.exec\fP(5)\&.
.PP
Beachten Sie, dass die beim Aufruf ohne Befehlszeilenschalter dargestellte
Partitionstabelle (wie nachfolgend angezeigt) nicht notwendigerweise alle im
Abbild enthaltenen Partitionen anzeigt, sondern nur die Partitionen, die
interpretiert und als Teil des Betriebssystemabbilds betrachtet
werden\&. Insbesondere werden Partitionen mit unbekanntem Typ ignoriert,
sowie doppelte Partitionen (d\&.h\&. mehr als eine Partition pro
Partitionstyp), sowie Wurzel und /usr/\-Partitionen von Architekturen, die
mit dem lokalen System nicht kompatibel sind\&. Mit anderen Worten: dieses
Werkzeug zeigt das an, womit es beim Einhängen des Abbilds umgehen
wird\&. Um die vollständige Liste der Partitionen anzuzeigen, verwenden Sie
ein Werkzeug wie \fBfdisk\fP(8)\&.
.PP
Der Befehl \fBsystemd\-dissect\fP kann als \fBmount\&.ddi\fP aufgerufen
werden\&. Dann implementiert er die »Externer\-Helfer«\-Schnittstelle von
\fBmount\fP(8)\&. Dies stellt sicher, dass dann zu \fBsystemd\-dissect\fP
kompatible Plattenabbilder direkt von \fBmount\fP und \fBfstab\fP(5) eingehängt
werden können\&. Weiter unten finden Sie hierzu Details\&.
.SH BEFEHLE
.PP
Falls keiner der nachfolgend aufgeführten Befehlszeilenschalter übergeben
wird, dann wird das angegebene Plattenabbild geöffnet und allgemeine
Informationen über das Abbild und die darin enthaltenen Partitionen und ihre
Verwendung werden ausgegeben\&.
.PP
\fB\-\-mount\fP, \fB\-m\fP
.RS 4
Hängt das angegebene Betriebssystemabbild in das angegebene Verzeichnis
ein\&. Dies wird das Abbild analysieren, das Wurzeldateisystem des
Betriebssystems ermitteln \(em sowie alle möglichen weiteren Partitionen
\(en und diese in das angegebene Verzeichnis einhängen\&. Falls das
Betriebssystem mehrere gemäß der \m[blue]\fBSpezifikation für auffindbare Partitionen\fP\m[]\&\s-2\u[1]\d\s+2 markierte Partitionen enthält, werden
mehrere, verschachtelte Einhängungen etabliert\&. Dieser Befehl erwartet
zwei Argumente: einen Pfad zu einer Abbilddatei und einen Pfad zu einem
Verzeichnis, in dem das Abbild eingehängt werden soll\&.
.sp
Um ein Betriebssystemabbild auszuhängen, das auf diese Weise eingehängt
wurde, verwenden Sie die Aktion \fB\-\-umount\fP\&.
.sp
Wenn das Betriebssystemabbild LUKS\-verschlüsselte oder
Verity\-Integritätsgeschützte Dateisysteme enthält, dann werden geeignete
Datenträger automatisch eingerichtet und für die automatische Zerlegung
markiert, wenn das Abbild ausgehängt wird.
.sp
Das Betriebssystemabbild kann entweder als Pfad zu einem in einer regulären
Datei gespeicherten Betriebssystemabbild angegeben sein oder sich auf einen
Blockgeräteknoten beziehen (in diesem Fall muss das Blockgerät das »gesamte«
Gerät sein, d\&.h\&. kein Partitionsgerät)\&. (Die weiteren hier
beschriebenen unterstützten Befehle unterstützen das auch\&.)
.sp
Alle eingehängten Dateisysteme werden mit der geeigneten
\fBfsck\fP(8)\-Implementierung im automatischen Korrekturmodus überprüft, außer
dies wird explizit mit (\fB\-\-fsck=no\fP) ausgeschaltet oder eine
schreibgeschützte Aktion wird erbeten (\fB\-\-read\-only\fP)\&.
.sp
Beachten Sie, dass diese Funktionalität auch mittels \fBmount \-t ddi Meinabbild\&.raw Zielverz/\fP in \fBmount\fP(8) sowie in \fBfstab\fP(5) verfügbar
ist\&. Weiter unten finden Sie hierzu Details\&.
.sp
Hinzugefügt in Version 247\&.
.RE
.PP
\fB\-M\fP
.RS 4
Dies ist ein Kürzel für \fB\-\-mount \-\-mkdir\fP\&.
.sp
Hinzugefügt in Version 247\&.
.RE
.PP
\fB\-\-umount\fP, \fB\-u\fP
.RS 4
Hängt ein Betriebssystemabbild aus dem angegebenen Verzeichnis aus\&. Dieser
Befehl erwartet ein Argument: ein Verzeichnis, in dem das
Betriebssystemabbild eingehängt wurde\&.
.sp
Alle eingehängten Partitionen werden rekursiv ausgehängt, und das
zugrundeliegende Loop\-Gerät wird entfernt, einschließlich aller seiner
Partitions\-Sub\-Geräte\&.
.sp
Hinzugefügt in Version 252\&.
.RE
.PP
\fB\-U\fP
.RS 4
Dies ist ein Kürzel für \fB\-\-umount \-\-rmdir\fP\&.
.sp
Hinzugefügt in Version 252\&.
.RE
.PP
\fB\-\-attach\fP
.RS 4
Hängt das angegebene Plattenabbild an ein automatisch reserviertes
Loopback\-Blockgerät an und gibt den Pfad zu dem Loopback\-Blockgerät auf der
Standardausgabe aus\&. Dies ist ähnlich zum Aufruf von \fBlosetup \-\-find \-\-show\fP, aber validiert das Abbild als DDI vor dem Anhängen und leitet die
zu verwendene korrekte Sektorgröße automatisch ab\&. Desweiteren stellt es
sicher, das die partitionsbezogenen Blockgeräte vor der Rückkehr automatisch
erstellt werden\&. Akzeptiert einen Pfad zu einer Plattenabbilddatei\&.
.sp
Hinzugefügt in Version 254\&.
.RE
.PP
\fB\-\-detach\fP
.RS 4
Hängt das angegebene Plattenabbild von dem Loopback\-Blockgerät ab\&. Dies
macht die oben beschriebene Wirkung von \fB\-\-attach\fP rückgängig\&. Dies
erwartet entweder einen Pfad zu einem Loopback\-Blockgerät als Argument oder
den Pfad zu der zugrundeliegenden Abbilddatei\&. Im zweiten Fall wird es
automatisch das richtige Gerät zum Abhängen bestimmen\&.
.sp
Hinzugefügt in Version 254\&.
.RE
.PP
\fB\-\-list\fP, \fB\-l\fP
.RS 4
Gibt die Pfade aller Dateien und Verzeichnisse in dem angegebenen
Betriebssystemabbild oder \-verzeichnis auf die Standardausgabe aus\&.
.sp
Hinzugefügt in Version 253\&.
.RE
.PP
\fB\-\-mtree\fP
.RS 4
Erstellt ein BSD\-\fBmtree\fP(8) kompatibles Datei\-Manifest für das angegebene
Plattenabbild oder Verzeichnis\&. Dies ist zum detaillierten Vergleich der
Abbild\-Inhalte, einschließlich der Inode\-Informationen und anderer
Metadaten, nützlich\&. Das erstellte Manifest enthält detaillierte
Inode\-Informationen, schließt aber derzeit erweiterte Attribute,
Dateisystem\-Capabilitys, MAC\-Tabellen, \fBchattr\fP(1)\-Dateischalter,
\fBbtrfs\fP(5)\-Teildatenträgerinformationen und verschiedene andere
Dateimetadaten aus\&. Dateiinhalte werden über einen SHA256\-Hash
dargestellt\&. In der Zukunft könnten zusätzliche Felder hinzugefügt
werden\&. Beachten Sie, dass Inode\-Informationen, wie Link\-Zähler,
Inode\-Nummern und Zeitstempel absichtlich aus der Ausgabe ausgeschlossen
werden, da diese typischerweise die Vergleichbarkeit erschweren\&.
.sp
Hinzugefügt in Version 253\&.
.RE
.PP
\fB\-\-with\fP
.RS 4
Führt den angegebenen Befehl mit dem angegebenen, eingehängten
Betriebssystemabbild aus\& Dies hängt das Abbild in ein temporäres
Verzeichnis ein, schaltet das aktuelle Arbeitsverzeichnis dort hin und ruft
die angegebene Befehlszeile als Kindprozess auf\&. Sobald der Prozess
beendet ist, wird das Abbild wieder ausgehängt und das temporäre Verzeichnis
entfernt\&. Falls kein Befehl angegeben ist, wird eine Shell
aufgerufen\&. Das Abbild wird schreibbar eingehängt, verwenden Sie
\fB\-\-read\-only\fP, um eine schreibgeschützte Aktion durchzuführen\&. Bei dem
aufgerufenen Prozess wird die Umgebungsvariable \fI$SYSTEMD_DISSECT_ROOT\fP
gesetzt sein und den absoluten Pfadnamen zu dem temporären Einhängepunkt
enthalten, d\&.h\&. das gleiche Verzeichnis, auf das auch das aktuelle
Arbeitsverzeichnis gesetzt ist\&. Er wird auch die Umgebungsvariable
\fI$SYSTEMD_DISSECT_DEVICE\fP gesetzt haben, die den absoluten Pfadnamen des
Loop\-Gerätes enthält, an das das Abbild angehängt wurde\&.
.sp
Hinzugefügt in Version 253\&.
.RE
.PP
\fB\-\-copy\-from\fP, \fB\-x\fP
.RS 4
Kopiert eine Datei oder ein Verzeichnis von dem angegebenen
Betriebssystemabbild oder \-verzeichnis an den angegebenen Ort auf dem
Dateisystem des Rechners\&. Erwartet drei Argumente: einen Pfad zu einer
Abbilddatei oder einem Verzeichnis, einen Quellpfad (relativ zu dem
Wurzelverzeichnis des Abbilds) und einen Zielpfad (relativ zum aktuellen
Arbeitsverzeichnis oder einen absoluten Pfad, beide außerhalb des
Abbilds)\&. Falls der Zielpfad nicht oder als Bindestrich (»\-«) angegeben
wird, wird die angegebene Datei in die Standardausgabe kopiert\&. Falls sich
der Quellpfad in dem Abbild\-Dateisystem auf eine reguläre Datei bezieht,
dann wird diese an den Zielpfad kopiert\&. In diesem Fall wird auch der
Zugriffsmodus, erweiterte Attribute und der Zeitstempel kopiert, aber die
Dateieigentümerschaft nicht\&. Falls sich der Quellpfad in dem Abbild auf
ein Verzeichnis bezieht, wird dies rekursiv mit allen enthaltenen Dateien
und Verzeichnissen an den Zielpfad kopiert\&. In diesem Fall werden auch die
Dateieigentümerschaften mit kopiert\&.
.sp
Hinzugefügt in Version 247\&.
.RE
.PP
\fB\-\-copy\-to\fP, \fB\-a\fP
.RS 4
Kopiert eine Datei oder ein Verzeichnis von dem angegebenen Ort im
Dateisystem des Rechners in das angegebene Betriebssystemabbild oder
Verzeichnis\&. Erwartet drei Argumente: einen Pfad zu einer Abbilddatei oder
einem Verzeichnis, einen Quellpfad (relativ zum aktuellen Arbeitsverzeichnis
oder ein absoluter Pfad, beide außerhalb des Abbilds) und Zielpfad (relativ
zu dem Wurzelverzeichnis des Abbilds)\&. Falls der Quellpfad nicht oder als
Bindestrich (»\-«) angegeben wird, werden die zu schreibenden Daten aus der
Standardeingabe gelesen\&. Falls sich der Quellpfad in dem Dateisystem des
Rechners auf eine reguläre Datei bezieht, dann wird diese an den Zielpfad
kopiert\&. In diesem Fall wird auch der Zugriffsmodus, erweiterte Attribute
und der Zeitstempel kopiert, aber die Dateieigentümerschaft nicht\&. Falls
sich der Quellpfad im Dateisystem des Rechners auf ein Verzeichnis bezieht,
wird dies rekursiv mit allen enthaltenen Dateien und Verzeichnissen an den
Zielpfad kopiert\&. In diesem Fall werden auch die Dateieigentümerschaften
mit kopiert\&.
.sp
Wie bei \fB\-\-mount\fP werden Dateisystemüberprüfungen implizit ausgeführt,
bevor die Kopieraktion beginnt\&.
.sp
Hinzugefügt in Version 247\&.
.RE
.PP
\fB\-\-discover\fP
.RS 4
Zeigt eine Liste von DDIs in gut bekannten Verzeichnissen\&. Dies wird
Maschinen\-, Portable\-Dienste\- und Systemerweiterungs/\-konfigurationsabbilder
in den normalen Verzeichnissen /usr/lib/machines/, /usr/lib/portables/,
/usr/lib/confexts/, /var/lib/machines/, /var/lib/portables/,
/var/lib/extensions/ und so weiter anzeigen\&.
.sp
Hinzugefügt in Version 253\&.
.RE
.PP
\fB\-\-validate\fP
.RS 4
Validiert die Partitionsanordnung eines Plattenabbildes (DDI) und stellt
sicher, dass es auf die mittels \fB\-\-image\-policy=\fP übergebene
Abbildrichtlinie passt, falls eine solche angegeben ist\&. Dies wertet die
Partitionstabelle aus und untersucht das Dateisystem in dem Abbild, aber
versucht nicht, es einzuhängen (noch die
Plattenverschlüsselung/\-authentifzierung mittels LUKS/Verity
einzurichten)\&. Es berücksichtigt die konfigurierte Analyserichtlinie\&. Da
diese Aktion kein Dateisystem einhängt, erfordert dieser Befehl \(em anders
als alle anderen von diesem Werkzeug implementierten Befehle \(em keine
Privilegien außer die Fähigkeit, auf die angegebene Datei zugreifen zu
können\&. Es wird »OK« ausgegeben und Null zurückgegeben, falls die Datei
korrekt erscheint und auf die angegebenen Analyserichtlinie
passt\&. Andernfalls wird eine Fehlermeldung ausgegeben und ein von Null
verschiedener Wert zurückgegeben\&.
.sp
Hinzugefügt in Version 254\&.
.RE
.PP
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Zeigt einen kurzen Hilfetext an und beendet das Programm\&.
.RE
.PP
\fB\-\-version\fP
.RS 4
Zeigt eine kurze Versionszeichenkette an und beendet das Programm\&.
.RE
.SH OPTIONEN
.PP
Die folgenden Optionen werden verstanden:
.PP
\fB\-\-read\-only\fP, \fB\-r\fP
.RS 4
Agiert im schreibgeschützten Modus\&. Standardmäßig wird \fB\-\-mount\fP
schreibbare Einhängepunkte etablieren\&. Wird diese Option angegeben, dann
werden sie stattdessen schreibgeschützt etabliert\&.
.sp
Hinzugefügt in Version 247\&.
.RE
.PP
\fB\-\-fsck=no\fP
.RS 4
Schaltet automatische Dateisystemüberprüfung aus\&. Standardmäßig wird das
Dateisystem innerhalb eines Betriebssystemabbildes automatisch mit dem
geeigneten \fBfsck\fP(8)\-Befehl (im Modus mit automatischer Korrektur)
überprüft, wenn auf das Abbild zum Schreiben (mittels \fB\-\-mount\fP oder
\fB\-\-copy\-to\fP) zugegriffen wird\&. Dieses Verhalten kann mittels \fB\-\-fsck=no\fP
ausgeschaltet werden\&.
.sp
Hinzugefügt in Version 247\&.
.RE
.PP
\fB\-\-growfs=no\fP
.RS 4
Schaltet das automatische Anwachsen der Dateisysteme, auf die zugegriffen
wird, auf die Partitionsgröße aus, falls das so in der GPT\-Partitionstablle
markiert ist\&. Standardmäßig wachsen die in den Betriebssystemabbildern
enthaltenen Dateisysteme automatisch auf ihre Partitionsgröße an, falls Bit
59 in den GPT\-Partitionsschaltern für Partitionstypen, die in der
\m[blue]\fBSpezifikation für auffindbare Partitionen\fP\m[]\&\s-2\u[1]\d\s+2
definiert sind, gesetzt ist, wenn auf ein Abbild schreibend (durch
\fB\-\-mount\fP oder \fB\-\-copy\-to\fP) zugegriffen wird\&. Dieses Verhalten kann
mittels \fB\-\-growfs=no\fP ausgeschaltet werden\&. Dateisysteme wachsen beim
Zugriff automatisch, falls alle der folgenden Bedingungen erfüllt sind:
.sp
.RS 4
.ie  n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
Das Dateisystem ist schreibbar eingehängt\&.
.RE
.sp
.RS 4
.ie  n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
Das Dateisystem ist derzeit kleiner als die Partition, in der es enthalten
ist (und kann daher anwachsen)\&.
.RE
.sp
.RS 4
.ie  n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
Das Abbild enthält eine GPT\-Partitionstabelle\&.
.RE
.sp
.RS 4
.ie  n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
Das Dateisystem ist auf einer Partitions gespeichert, die in der
Spezifikation für auffindbare Partitionen definiert ist\&.
.RE
.sp
.RS 4
.ie  n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  5." 4.2
.\}
Bit 59 der GPT\-Partitionsschalter für diese Partition ist
spezifikationsgemäß gesetzt\&.
.RE
.sp
.RS 4
.ie  n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  6." 4.2
.\}
Die Option \fB\-\-growfs=no\fP wurde nicht übergeben\&.
.RE
.sp
Hinzugefügt in Version 249\&.
.RE
.PP
\fB\-\-mkdir\fP
.RS 4
Bei Kombination mit \fB\-\-mount\fP wird das Verzeichnis, in das das
Betriebssystemabbild eingehängt werden soll, erstellt, falls es
fehlt\&. Beachten Sie, dass dieses Verzeichnis nicht automatisch entfernt
wird, wenn das Plattenabbild ausgehängt wird\&.
.sp
Hinzugefügt in Version 247\&.
.RE
.PP
\fB\-\-rmdir\fP
.RS 4
Falls mit \fB\-\-umount\fP kombiniert wird das angegebene Verzeichnis, indem das
Betriebssystemabbild eingehängt ist, entfernt, nachdem das
Betriebssystemabbild ausgehängt wurde\&.
.sp
Hinzugefügt in Version 252\&.
.RE
.PP
\fB\-\-discard=\fP
.RS 4
Akzeptiert entweder »disabled«, »loop«, »all« oder »crypto«\&. Bei
»disabled« wird auf das Abbild zugegriffen, ohne leere Blöcke zu
verwerfen\&. Bei »loop« ist das Verwerfen aktiviert, falls auf einer
regulären Datei agiert wird\&. Bei »crypt« ist Verwerfen aktiviert, selbst
wenn auf verschlüsselten Dateisystemen agiert wird\&. Bei »all« wird das
Verwerfen ohne weitere Bedingungen aktiviert\&.
.sp
Hinzugefügt in Version 247\&.
.RE
.PP
\fB\-\-in\-memory\fP
.RS 4
Falls angegeben wird eine speicherinterne Kopie des angegebenen
Plattenabbildes benutzt\&. Dies kann zum schreibenden Zugriff auf ein
(möglicherweise schreibgeschütztes) Abbild verwandt werden, ohne dass die
ursprüngliche Datei verändert wird\&. Dann kann auch zum Arbeiten auf
Plattenabbildern verwandt werden, ohne das ursprüngliche Dateisystem
beschäftigt zu halten, das somit ausgehängt werden kann\&.
.sp
Hinzugefügt in Version 253\&.
.RE
.PP
\fB\-\-root\-hash=\fP, \fB\-\-root\-hash\-sig=\fP, \fB\-\-verity\-data=\fP
.RS 4
Konfiguriert verschiedene Aspekte der Verity\-Datenintegrität für das
Betriebssystemabbild\&. Option \fB\-\-root\-hash=\fP gibt einen hexadezimal
kodierten Verity\-Hash der obersten Stufe an, für die Einrichtung des
Verity\-Integritätsschutzes\&. Option \fB\-\-root\-hash\-sig=\fP gibt den Pfad zu
einer Datei an, die eine PKCS#7\-Signatur für den Hash enthält\&. Diese
Signatur wird während der Aktivierung an den Kernel übergeben, der diese
dann mit den Signaturschlüsseln vergleicht, die im Kernel\-Schlüsselbund
enthalten sind\&. Option \fB\-\-verity\-data=\fP gibt einen Pfad zu einer Datei
mit den Verity\-Daten an, die für das Betriebssystem\-Abbild verwandt werden
sollen, falls diese in einer abgetrennten (separaten) Datei gespeichert
sind\&. Es wird empfohlen, die Verity\-Daten direkt in das Abbild einzubetten
und hierfür den Verity\-Mechanismus in der \m[blue]\fBSpezifikation für auffindbare Partitionen\fP\m[]\&\s-2\u[1]\d\s+2 zu verwenden\&.
.sp
Hinzugefügt in Version 247\&.
.RE
.PP
\fB\-\-loop\-ref=\fP
.RS 4
Konfiguriert die »Referenz«\-Zeichenkette, die der Kernel als
zugrundeliegende Datei für das Loopback\-Blockgerät berichten soll\&. Es
sollte zwar ein Pfad oder ein Dateiname sein, der die zugrundeliegende Datei
referenziert, allerdings wird dies nicht erzwungen und der Kernel akzeptiert
beliebige, vom Benutzer ausgewählte formatfreie Zeichenketten\&. Akzeptiert
eine beliebige Zeichenkette mit bis zu 63 Zeichen\&. Dies setzt das Feld
»\&.lo_file_name« des Kernels für das Blockgerät\&. Beachten Sie, dass dies
von der Attributdatei /sys/class/block/loopX/loop/backing_file, die immer
einen auf die zugrundeliegende Datei zeigenden Pfad berichtet, verschieden
ist\&. Letzterer Pfad unterliegt der Einhängenamensraumübersetzung, während
die erstere Zeichenkette dies nicht tut\&.
.sp
Diese Einstellung ist besonders in Zusammenhang mit dem Befehl \fB\-\-attach\fP
nützlich, da sie späteres Referenzieren des reservierten Loop\-Gerätes
mittels Symlinks /dev/disk/by\-loop\-ref/… ermöglicht\&. Beispiel: Zuerst wird
das Loopback\-Gerät mittels \fBsystemd\-dissect attach \-\-loop\-ref=quux foo\&.raw\fP eingerichtet, und dann wird es in einem Befehl mittels des
festgelegten Dateinamens referenziert: \fBcfdisk /dev/disk/by\-loop\-ref/quux\fP\&.
.sp
Hinzugefügt in Version 254\&.
.RE
.PP
\fB\-\-mtree\-hash=no\fP
.RS 4
Falls mit \fB\-\-mtree\fP kombiniert schaltet sie die Einbindung von Datei\-Hashes
in die Mtree\-Ausgabe aus\&. Dies beschleunigt \fB\-\-mtree\fP beim Betrieb auf
großen Abbildern\&.
.sp
Hinzugefügt in Version 254\&.
.RE
.PP
\fB\-\-image\-policy=\fP\fIRichtlinie\fP
.RS 4
Akzeptiert gemäß \fBsystemd.image\-policy\fP(7) eine
Abbildrichtlinienzeichenkette als Argument\&. Die Richtlinie wird bei
Aktionen auf dem mittels \fB\-\-image=\fP angegebenen Plattenabbild durchgesetzt,
siehe oben\&. Falls nicht angegeben ist die Vorgabe die Richtlinie »*«,
d\&.h\&. alle erkannten Dateisysteme im Abbild werden verwandt\&.
.RE
.PP
\fB\-\-no\-pager\fP
.RS 4
Leitet die Ausgabe nicht an ein Textanzeigeprogramm weiter\&.
.RE
.PP
\fB\-\-no\-legend\fP
.RS 4
Gibt die Legende nicht aus, d\&.h\&. die Spaltenköpfe und die Fußzeile mit
Hinweisen\&.
.RE
.PP
\fB\-\-json=\fP\fIMODUS\fP
.RS 4
Zeigt die Ausgabe als JSON formatiert\&. Erwartet entweder »short« (für die
kürzest mögliche Ausgabe ohne unnötigen Leerraum oder Zeilenumbrüche),
»pretty« (für eine schönere Version der gleichen Ausgabe, mit Einzügen und
Zeilenumbrüchen) oder »off« (um die standardmäßig aktivierte JSON\-Ausgabe
auszuschalten)\&.
.RE
.SH EXIT\-STATUS
.PP
Im Erfolgsfall wird 0 zurückgeliefert, andernfalls ein von Null
verschiedener Code für den Fehlschlag\&. Falls der Befehl \fB\-\-with\fP verwandt
wird, wird der Exit\-Status des aufgerufenen Befehls weitergeleitet\&.
.SH "AUFRUF ALS /SBIN/MOUNT\&.DDI"
.PP
Das Programm \fBsystemd\-dissect\fP kann ein Symlink auf /sbin/mount\&.ddi
sein\&. Falls es so aufgerufen wird, implementiert es die Schnittstelle
»externer Helfer« von \fBmount\fP(8) für den Pseudo\-Dateisystemtyp »ddi«\&. Das
bedeutet, dass konforme Plattenabbilder direkt mittels
.sp
.if  n \{\
.RS 4
.\}
.nf
# mount \-t ddi meinabbild\&.raw Zielverz/
.fi
.if  n \{\
.RE
.\}
.PP
auf eine Art eingehängt werden können, die größteils gleichbedeutend mit
Folgendem ist:
.sp
.if  n \{\
.RS 4
.\}
.nf
# systemd\-dissect \-\-mount meinabbild\&.raw Zielverz/
.fi
.if  n \{\
.RE
.\}
.PP
Beachten Sie, dass ein einzelnes DDI mehrere Dateisysteme enthalten
kann\&. Es sollte daher später mit \fBumount \-R  Zielverz/\fP für rekursive
Aktion ausgehängt werden\&.
.PP
Diese Funktionalität ist besonders nützlich, um DDIs automatisch beim
Systemstart mittels eines einfachen Eintrags in /etc/fstab
einzuhängen\&. Beispiel:
.sp
.if  n \{\
.RS 4
.\}
.nf
/Pfad/zu/meinabbild\&.raw /images/meinabbild/ ddi defaults 0 0
.fi
.if  n \{\
.RE
.\}
.PP
Beim Aufruf auf diese Art werden die Einhängeoptionen »ro«, »rw«, »discard«,
»nodiscard« auf die entsprechenden, oben augeführten Optionen abgebildet
(d\&.h\&. \fB\-\-read\-only\fP, \fB\-\-discard=all\fP,
\fB\-\-discard=disabled\fP)\&. Einhängeoptionen werden \fInicht\fP generisch an das
Dateisystem innerhalb von Abbildern weitergegeben\&.
.SH BEISPIELE
.PP
\fBBeispiel\ \&1.\ \&Einen Tarball aus einem Plattenabbild erstellen\fP
.sp
.if  n \{\
.RS 4
.\}
.nf
# systemd\-dissect \-\-with foo\&.raw tar cz \&. >foo\&.tar\&.gz
.fi
.if  n \{\
.RE
.\}
.SH "SIEHE AUCH"
.PP
\fBsystemd\fP(1), \fBsystemd\-nspawn\fP(1), \fBsystemd.exec\fP(5),
\m[blue]\fBSpezifikation für auffindbare Partitionen\fP\m[]\&\s-2\u[1]\d\s+2,
\fBmount\fP(8), \fBumount\fP(8), \fBfdisk\fP(8)
.SH ANMERKUNGEN
.IP " 1." 4
Spezifikation für auffindbare Partitionen
.RS 4
\%https://uapi\-group.org/specifications/specs/discoverable_partitions_specification
.RE
.PP
.SH ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von
Helge Kreutzmann <debian@helgefjell.de>
erstellt.
.PP
Diese Übersetzung ist Freie Dokumentation; lesen Sie die
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
oder neuer bezüglich der
Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
.PP
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an die
.MT debian-l10n-german@lists.debian.org
Mailingliste der Übersetzer
.ME .