Provided by: manpages-de_4.27.0-1_all 
BEZEICHNUNG
systemd-gpt-auto-generator - Generator zum automatischen Entdecken und Einhängen der Partitionen »root«,
/home/, /srv/, /var/ und /var/tmp/ sowie Entdecken und Einhängen der Swap-Partition, basierend auf dem
GPT-Partitionstyp GUIDs
ÜBERSICHT
/usr/lib/systemd/system-generators/systemd-gpt-auto-generator
BESCHREIBUNG
systemd-gpt-auto-generator ist ein Unit-Generator, der die Partitionen der Wurzel, /home/, /srv/, /var/,
/var/tmp/, die EFI-Systempartition (ESP), des »Extended Boot Loader« (XBOOTLDR) und Swap automatisch
erkennt und Einhänge- und Swap-Units für diese, basierend auf den Partitionstyp-GUIDS von
GUID-Partitionstabellen (GPT), erstellt. Siehe UEFI-Spezifikation[1], Kapitel 5 für weitere Details. Es
implementiert die Spezifikation für auffindbare Partitionen[2].
Beachten Sie, dass dieser Generator nur auf GPT-Systemen wirksam wird. Er wird keine
Einhängepunktkonfigurationen für Verzeichnisse erstellen, die bereits Dateien enthalten oder falls der
Einhängepunkt explizit in fstab(5) konfiguriert ist. Zusätzlich wird für die ESP- oder XBOOTLDR-Partition
keine Unit erstellt, falls Einhängeeinträge in den Hierarchien /boot/ oder /efi/ in fstab(5) gefunden
werden.
Falls die von diesem Generator erstellten Units außer Kraft gesetzt werden, beispielsweise durch Units
mit höherem Vorrang, können von diesem Generator erstellte Ergänzungen und zusätzliche Abhängigkeiten
weiterhin verwandt werden.
Dieser Generator wird nur nach Wurzelpartitionen auf der gleichen physischen Platte, auf der sich auch
die EFI-Systempartition (ESP) befindet, suchen. Beachten Sie, dass Unterstützung durch das
Systemstartprogramm benötigt wird: die EFI-Variable LoaderDevicePartUUID der Lieferanten-UUID
4a67b082-0a4c-41cf-b6c7-440b29bb8c4f wird verwandt, um zu bestimmen, von welcher Partition und somit
welcher Platte das System gestartet wurde. Falls das Systemstartprogramm diese Variable nicht setzt, wird
der Generator nicht in der Lage sein, die Wurzelpartition zu erkennen. Siehe die
Boot-Loader-Schnittstelle[3] für Details.
Ähnlich wird dieser Generator nur nach den anderen Partitionen auf der gleichen physischen Platte, auf
der sich auch die Wurzelpartition befindet, suchen. In diesem Fall wird die Unterstützung durch das
Systemstartprogramm nicht benötigt. Diese Partitionen werden auf Systemen, bei denen sich das
Wurzeldateisystem über mehrere Platten, beispielsweise mittels btrfs-RAID, erstreckt, nicht gesucht.
Systemd-gpt-auto-generator ist für die Zentralisierung der Dateisystemkonfiguration in der
Partitionstabelle nützlich und macht Konfiguration in /etc/fstab oder auf der Kernelbefehlszeile unnötig.
Dieser Generator sucht Partitionen basierend auf ihrer Partitionstyp-GUID. Die nachfolgenden
Partitionstyp-GUIDs werden identifiziert:
Tabelle 1. Partitionstyp-GUIDs
┌─────────────────────────┬──────────────────────────────────────┬──────────────────────────────┬───────────────────┬──────────────────────┐
│ Partitionstyp │ GUID │ Name │ Einhängepunkt │ Erklärung │
├─────────────────────────┼──────────────────────────────────────┼──────────────────────────────┼───────────────────┼──────────────────────┤
│ SD_GPT_ROOT_X86_64 │ 4f68bce3-e8cd-4db1-96e7-fbcaf984b709 │ Wurzelpartition │ / │ Die erste Partition │
│ │ │ (x86-64) │ │ mit dieser Art │
│ │ │ │ │ UUID, auf der │
│ │ │ │ │ gleichen Platte wie │
│ │ │ │ │ der zum Systemstart │
│ │ │ │ │ verwandte ESP │
│ │ │ │ │ befindlich, wird │
│ │ │ │ │ als │
│ │ │ │ │ Wurzeldateisystem / │
│ │ │ │ │ auf AMD 64 / │
│ │ │ │ │ 64-bit-x86-Systemen │
│ │ │ │ │ verwandt. │
├─────────────────────────┼──────────────────────────────────────┼──────────────────────────────┼───────────────────┼──────────────────────┤
│ SD_GPT_ROOT_ARM64 │ b921b045-1df0-41c3-af44-4c6f280d3fae │ Wurzelpartition │ / │ Die erste Partition │
│ │ │ (64-bit ARM) │ │ mit dieser Art │
│ │ │ │ │ UUID, auf der │
│ │ │ │ │ gleichen Platte wie │
│ │ │ │ │ der zum Systemstart │
│ │ │ │ │ verwandte ESP │
│ │ │ │ │ befindlich, wird │
│ │ │ │ │ als │
│ │ │ │ │ Wurzeldateisystem / │
│ │ │ │ │ auf AArch64 / │
│ │ │ │ │ 64-bit-ARM-Systemen │
│ │ │ │ │ verwandt. │
├─────────────────────────┼──────────────────────────────────────┼──────────────────────────────┼───────────────────┼──────────────────────┤
│ SD_GPT_ROOT_ALPHA │ … │ Wurzelpartitionen │ / │ Die erste Partition │
│ SD_GPT_ROOT_ARC │ │ für andere │ │ mit dieser Art von │
│ SD_GPT_ROOT_ARM │ │ Architekturen │ │ UUID, die auf die │
│ SD_GPT_ROOT_ARM64 │ │ │ │ Architektur passt │
│ SD_GPT_ROOT_IA64 │ │ │ │ und sich auf der │
│ SD_GPT_ROOT_LOONGARCH64 │ │ │ │ gleichen Platte wie │
│ SD_GPT_ROOT_MIPS │ │ │ │ der zum Systemstart │
│ SD_GPT_ROOT_MIPS64 │ │ │ │ verwandte ESP │
│ SD_GPT_ROOT_MIPS_LE │ │ │ │ befindet, wird als │
│ SD_GPT_ROOT_MIPS64_LE │ │ │ │ Wurzeldateisystem / │
│ SD_GPT_ROOT_PARISC │ │ │ │ verwandt. Sie │
│ SD_GPT_ROOT_PPC │ │ │ │ finden eine │
│ SD_GPT_ROOT_PPC64 │ │ │ │ vollständige Liste │
│ SD_GPT_ROOT_PPC64_LE │ │ │ │ und die Werte der │
│ SD_GPT_ROOT_RISCV32 │ │ │ │ Konstanten in der │
│ SD_GPT_ROOT_RISCV64 │ │ │ │ Spezifikation für │
│ SD_GPT_ROOT_S390 │ │ │ │ auffindbare │
│ SD_GPT_ROOT_S390X │ │ │ │ Partitionen[2]. │
│ SD_GPT_ROOT_TILEGX │ │ │ │ │
│ SD_GPT_ROOT_X86 │ │ │ │ │
│ SD_GPT_ROOT_X86_64 │ │ │ │ │
│ SD_GPT_USR_ALPHA │ │ │ │ │
│ SD_GPT_USR_ARC │ │ │ │ │
│ SD_GPT_USR_ARM │ │ │ │ │
│ SD_GPT_USR_IA64 │ │ │ │ │
│ SD_GPT_USR_LOONGARCH64 │ │ │ │ │
│ SD_GPT_USR_MIPS_LE │ │ │ │ │
│ SD_GPT_USR_MIPS64_LE │ │ │ │ │
│ SD_GPT_USR_PARISC │ │ │ │ │
│ SD_GPT_USR_PPC │ │ │ │ │
│ SD_GPT_USR_PPC64 │ │ │ │ │
│ SD_GPT_USR_PPC64_LE │ │ │ │ │
│ SD_GPT_USR_RISCV32 │ │ │ │ │
│ SD_GPT_USR_RISCV64 │ │ │ │ │
│ SD_GPT_USR_S390 │ │ │ │ │
│ SD_GPT_USR_S390X │ │ │ │ │
│ SD_GPT_USR_TILEGX │ │ │ │ │
│ SD_GPT_USR_X86 │ │ │ │ │
├─────────────────────────┼──────────────────────────────────────┼──────────────────────────────┼───────────────────┼──────────────────────┤
│ SD_GPT_HOME │ 933ac7e1-2eb4-4f13-b844-0e14e2aef915 │ Home-Partition │ /home/ │ Die erste Partition │
│ │ │ │ │ mit dieser Art von │
│ │ │ │ │ UUID auf der │
│ │ │ │ │ gleichen Platte wie │
│ │ │ │ │ die Wurzelpartition │
│ │ │ │ │ wird als /home/ │
│ │ │ │ │ eingehängt. │
├─────────────────────────┼──────────────────────────────────────┼──────────────────────────────┼───────────────────┼──────────────────────┤
│ SD_GPT_SRV │ 3b8f8425-20e0-4f3b-907f-1a25a76f98e8 │ Server-Datenpartition │ /srv/ │ Die erste Partition │
│ │ │ │ │ mit dieser Art von │
│ │ │ │ │ UUID auf der │
│ │ │ │ │ gleichen Platte wie │
│ │ │ │ │ die Wurzelpartition │
│ │ │ │ │ wird als /srv/ │
│ │ │ │ │ eingehängt. │
├─────────────────────────┼──────────────────────────────────────┼──────────────────────────────┼───────────────────┼──────────────────────┤
│ SD_GPT_VAR │ 4d21b016-b534-45c2-a9fb-5c16e091fd2d │ Variable-Daten-Partition │ /var/ │ Die erste Partition │
│ │ │ │ │ mit dieser Art von │
│ │ │ │ │ UUID auf der │
│ │ │ │ │ gleichen Platte wie │
│ │ │ │ │ die Wurzelpartition │
│ │ │ │ │ wird als /var/ │
│ │ │ │ │ eingehängt – │
│ │ │ │ │ vorausgesetzt, │
│ │ │ │ │ seine │
│ │ │ │ │ Partitions-UUID │
│ │ │ │ │ passt auf die │
│ │ │ │ │ ersten 128 bit des │
│ │ │ │ │ HMAC-SHA256 der │
│ │ │ │ │ GPT-Typ-UUID dieser │
│ │ │ │ │ Partition, wobei │
│ │ │ │ │ der Index die in │
│ │ │ │ │ machine-id(5) │
│ │ │ │ │ gespeicherte │
│ │ │ │ │ Maschinenkennung │
│ │ │ │ │ der Installation │
│ │ │ │ │ ist. Diese kann │
│ │ │ │ │ mittels │
│ │ │ │ │ systemd-id128(1) │
│ │ │ │ │ erstellt werden. │
├─────────────────────────┼──────────────────────────────────────┼──────────────────────────────┼───────────────────┼──────────────────────┤
│ SD_GPT_TMP │ 7ec6f557-3bc5-4aca-b293-16ef5df639d1 │ Temporäre-Daten-Partition │ /var/tmp/ │ Die erste Partition │
│ │ │ │ │ mit dieser Art von │
│ │ │ │ │ UUID auf der │
│ │ │ │ │ gleichen Platte wie │
│ │ │ │ │ die Wurzelpartition │
│ │ │ │ │ wird als /var/tmp/ │
│ │ │ │ │ eingehängt. │
├─────────────────────────┼──────────────────────────────────────┼──────────────────────────────┼───────────────────┼──────────────────────┤
│ SD_GPT_SWAP │ 0657fd6d-a4ab-43c4-84e5-0933c84b4f4f │ Swap │ n.Z. │ Alle Partitionen │
│ │ │ │ │ mit dieser Art von │
│ │ │ │ │ UUID auf der │
│ │ │ │ │ gleichen Platte wie │
│ │ │ │ │ die Wurzelpartition │
│ │ │ │ │ werden als │
│ │ │ │ │ Auslagerungsspeicher │
│ │ │ │ │ verwandt. │
├─────────────────────────┼──────────────────────────────────────┼──────────────────────────────┼───────────────────┼──────────────────────┤
│ SD_GPT_ESP │ c12a7328-f81f-11d2-ba4b-00a0c93ec93b │ EFI-Systempartition (ESP) │ /efi/ oder /boot/ │ Die erste Partition │
│ │ │ │ │ mit dieser Art von │
│ │ │ │ │ UUID auf der │
│ │ │ │ │ gleichen Platte wie │
│ │ │ │ │ die Wurzelpartition │
│ │ │ │ │ wird als /boot/ oder │
│ │ │ │ │ /efi/ eingehängt, │
│ │ │ │ │ siehe unten. │
├─────────────────────────┼──────────────────────────────────────┼──────────────────────────────┼───────────────────┼──────────────────────┤
│ SD_GPT_XBOOTLDR │ bc13c2ff-59e6-4262-a352-b275fd6f7172 │ Erweiterte │ /boot/ │ Die erste Partition │
│ │ │ Systemstartprogrammpartition │ │ mit dieser Art von │
│ │ │ │ │ UUID auf der │
│ │ │ │ │ gleichen Platte wie │
│ │ │ │ │ die Wurzelpartition │
│ │ │ │ │ wird als /boot/ │
│ │ │ │ │ eingehängt, siehe │
│ │ │ │ │ unten. │
└─────────────────────────┴──────────────────────────────────────┴──────────────────────────────┴───────────────────┴──────────────────────┘
Dieser Generator versteht die folgenden Attributschalter für Partitionen:
Tabelle 2. Partitionsattributsschalter
┌──────────────────────────────────┬────────────────────┬─────────────────────┬────────────────────────┐
│ Schalter │ Wert │ anwendbar auf │ Erklärung │
├──────────────────────────────────┼────────────────────┼─────────────────────┼────────────────────────┤
│ SD_GPT_FLAG_READ_ONLY │ 0x1000000000000000 │ /, /home/, /srv/, │ Partition ist │
│ │ │ /var/, /var/tmp/, │ schreibgeschützt │
│ │ │ »Extended Boot │ eingehängt │
│ │ │ Loader«-Partition │ │
├──────────────────────────────────┼────────────────────┼─────────────────────┼────────────────────────┤
│ SD_GPT_FLAG_NO_AUTO │ 0x8000000000000000 │ /, /home/, /srv/, │ Partition wird nicht │
│ │ │ /var/, /var/tmp/, │ automatisch eingehängt │
│ │ │ »Extended Boot │ │
│ │ │ Loader«-Partition │ │
├──────────────────────────────────┼────────────────────┼─────────────────────┼────────────────────────┤
│ SD_GPT_FLAG_NO_BLOCK_IO_PROTOCOL │ 0x0000000000000002 │ EFI-Systempartition │ Partition wird nicht │
│ │ │ (ESP) │ automatisch eingehängt │
└──────────────────────────────────┴────────────────────┴─────────────────────┴────────────────────────┘
Die Partitionen /home/, /srv/, /var/, /var/tmp/ und für Auslagerung können im LUKS-Format verschlüsselt
sein. In diesem Fall wird ein Device-Mapper-Gerät unter den Namen /dev/mapper/home, /dev/mapper/srv,
/dev/mapper/var, /dev/mapper/tmp oder /dev/mapper/swap eingerichtet. Beachten Sie, dass dies Konflikte
hervorrufen könnte, falls die gleiche Partition in /etc/crypttab mit einem anderen
Device-Mapper-Gerätenamen eingetragen ist.
Wenn Systemd in der Initrd läuft, kann die Partition / auch mit LUKS verschlüsselt sein. In diesem Fall
wird ein Device-Mapper-Gerät unter dem Namen /dev/mapper/root eingerichtet und ein sysroot.mount wird
eingerichtet, das das Gerät unter /sysroot einhängt. Für weitere Informationen siehe bootup(7).
Die Wurzelpartition kann durch Symlinken von /run/systemd/volatile-root nach /dev/block/$major:$minor
festgelegt werden. Dies ist insbesondere nützlich, falls die Wurzeleinhängung durch irgendeine Art von
flüchtigem Dateisystem (Overlayfs) ersetzt wurde.
Auf EFI-Systemen werden Einhänge- und Autoumount-Units für die EFI-Systempartition (ESP) und Erweiterte
Systemstartladepartitionen (XBOOTLDR) erstellt. Falls die Platte eine XBOOTLDR-Partition enthält, wie sie
in der Systemladerspezifikation[4] definiert ist, wird diese unter /boot/ zur Verfügung gestellt. Dieser
Generator erstellt eine Automount-Unit; die Einhängung wird nur bedarfsgesteuert beim Zugriff aktiviert.
Falls notwendig wird der Einhängepunkt erstellt.
Der ESP wird unter /boot/ eingehängt, falls das Verzeichnis existiert und nicht für XBOOTLDR genutzt
wird, andernfalls unter /efi/. Genau wie bei /boot/ wird eine Automount-Unit verwandt. Falls notwendig
wird der Einhängepunkt erstellt.
Für Einhängepunkte, die in fstab(5) konfiguriert sind oder Dateien enthalten wird keine Konfiguration
erstellt.
Wenn Sie diesen Generator im Zusammenspiel mit dem Dateisystem Btrfs verwenden, stellen Sie sicher, dass
Sie mit btrfs subvolume set-default die korrekten Teildatenträger (Subvolumes) setzen..
Falls das System über systemd-stub(7) gestartet wurde und der Rumpf dem Anwendungsraum meldete, dass das
Kernelabbild in ein TPM2-PCR eingemessen wurde, dann werden alle ermittelten Datenträgerkennzeichnungen
für root und /var/ (und Datenträgerverschlüsselungsschlüssel, falls sie verschlüsselt sind) automatisch
in PCR 15 bei der Akivierung über systemd-pcrfs@.service(8) eingemessen.
systemd-gpt-auto-generator implementiert systemd.generator(7).
KERNEL-BEFEHLSZEILE
systemd-gpt-auto-generator versteht die folgenden Kernelbefehlszeilenparameter:
systemd.gpt_auto, rd.systemd.gpt_auto
Diese Optionen akzeptieren ein optionales logisches Argument und sind standardmäßig »yes«. Der
Generator wird standardmäßig aktiviert und ein false-Wert kann zu seiner Deaktivierung verwandt
werden (z.B. »systemd.gpt_auto=0«).
Hinzugefügt in Version 242.
systemd.image_policy=
Akzeptiert eine Abbildanalyse-Richtlinienzeichenkette als Argument (gemäß systemd.image-policy(7))
und erlaubt das Durchsetzen einer Richtlinie bei der Analyse und die Verwendung der automatisch
erkannten GPT-Partitionstabelleneinträge.
Hinzugefügt in Version 254.
root=, rootfstype=, rootflags=
Wird root= zusammen mit dem besonderen Wert »gpt-auto« verwandt (oder der Parameter überhaupt nicht
benutzt wird), ist die automatische Erkennung der Wurzelpartition basierend auf dem GPT-Partitionstyp
aktiviert. Alle anderen Werte deaktivieren diese Logik.
Die rootfstype= und rootflags= werden zur Auswahl des Dateisystemtyps und der Optionen verwandt, wenn
das Wurzeldateisystem automatisch ermittelt wird.
Hinzugefügt in Version 242.
rw, ro
Hängt die Wurzelpartition anfänglich les-schreibbar oder nur lesbar ein.
Beachten Sie, dass anders als bei den meisten Kernelbefehlszeilenoptionen diese Einstellungen nicht
die Konfigurationen im Dateisystem außer Kraft setzen und das Dateisystem später neu eingehängt
werden könnte. Siehe systemd-remount-fs.service(8).
Hinzugefügt in Version 242.
systemd.swap=
Akzeptiert ein logisches Argument oder aktiviert die Option, falls kein Argument angegeben ist. Falls
deaktiviert, wird die automatische Erkennung von Auslagerungspartition(en), basierend auf dem
GPT-Partitionstyp, deaktiviert. Standardmäßig aktiviert.
Hinzugefügt in Version 254.
SIEHE AUCH
systemd(1), systemd.mount(5), systemd.swap(5), systemd-fstab-generator(8),
systemd-cryptsetup@.service(8), systemd-pcrfs@.service(8), machine-id(5), cryptsetup(8), fstab(5),
btrfs(8)
ANMERKUNGEN
1. UEFI-Spezifikation
https://uefi.org/specifications
2. Spezifikation für auffindbare Partitionen
https://uapi-group.org/specifications/specs/discoverable_partitions_specification
3. Boot-Loader-Schnittstelle
https://systemd.io/BOOT_LOADER_INTERFACE
4. Systemladerspezifikation
https://uapi-group.org/specifications/specs/boot_loader_specification
Ü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: debian-l10n-german@lists.debian.org.
systemd 257.6 SYSTEMD-GPT-AUTO-GENERATOR(8)