SYSTEMD-GPT-AUTO-GENERATOR(8) systemd-gpt-auto-generator BEZEICHNUNG systemd-gpt-auto-generator - Generator zum automatischen Entdecken und Einhangen der Partitionen >>root<<, /home/, /srv/, /var/ und /var/tmp/ sowie Entdecken und Einhangen der Swap-Partition, basierend auf dem GPT-Partitionstyp GUIDs UBERSICHT /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 Einhange- und Swap-Units fur diese, basierend auf den Partitionstyp-GUIDS von GUID-Partitionstabellen (GPT), erstellt. Siehe UEFI-Spezifikation[1], Kapitel 5 fur weitere Details. Es implementiert die UAPI.2-Spezifikation fur auffindbare Partitionen[2]. Beachten Sie, dass dieser Generator nur auf GPT-Systemen wirksam wird. Er wird keine Einhangepunktkonfigurationen fur Verzeichnisse erstellen, die bereits Dateien enthalten oder falls der Einhangepunkt explizit in fstab(5) konfiguriert ist. Zusatzlich wird fur die ESP- oder XBOOTLDR-Partition keine Unit erstellt, falls Einhangeeintrage in den Hierarchien /boot/ oder /efi/ in fstab(5) gefunden werden. Falls die von diesem Generator erstellten Units ausser Kraft gesetzt werden, beispielsweise durch Units mit hoherem Vorrang, konnen von diesem Generator erstellte Erganzungen und zusatzliche Abhangigkeiten weiterhin verwandt werden. Bei der Ausfuhrung in der anfanglichen RAM-Platte (Initrd) kann dieser Generator automatisch nach dem Wurzeldateisystem suchen. Insbesondere: o Er wird nur nach Wurzelpartitionen auf der gleichen physischen Platte, auf der sich auch die EFI-Systempartition (ESP) befindet, suchen. Beachten Sie, dass Unterstutzung durch das Systemstartprogramm benotigt wird, damit das funktioniert: 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 Systemstartlader-Schnittstelle[3] fur Details. o Alternativ wird er nach dem Wurzeldateisystem auf dem Loopback-Blockgerat suchen, dessen Feld >>&.lo_name<< auf eine der wortlichen Zeichenketten >>rootdisk<< oder >>rootdisk.raw<< gesetzt ist. Stellen Sie fur Abbilder, die mittels systemd-import-generator(8) heruntergeladen wurden, sicher, die Option >>blockdev<< und den lokalen Namen auf die Zeichenkette >>rootdisk<< zu setzen, um diese Auswirkung zu erreichen. Beachten Sie, dass die Erkennung des Wurzeldateisystems auf Loopback-Blockgeraten dieser Art nur erfolgt, falls >>root=gpt-auto<< oder >>root=dissect<< explizit auf der Kernelbefehlszeile angegeben ist. Dies ist anders als bei der Erkennung basierend auf dem vom Systemstartprogramm berichteten ESP, der auch aktiviert wird, falls uberhaupt kein Parameter >>root=<< angegeben ist. (Letztere verlasst sich auf die Erstellung des Symlinks des Blockgerates durch /dev/gpt-auto-root von systemd-udevd.service.) Bei der Ausfuhrung auf dem Hauptsystem (d.h. nach erfolgreichem Ubergang aus der Initrd in das Wurzeldateisystem) wird dieser Generator nach allen anderen Partitionen auf der gleichen physischen Platte wie die Wurzelpartition suchen. Fur diese Ermittlung wird keine Unterstutzung durch das Systemstartprogramm benotigt. Desweiteren ist es nicht notwendig, dass die Wurzelpartition durch die Initrd automatisch erkannt wurde (wie oben beschrieben), damit die Erkennung der anderen Dateipartitionen stattfindet. Anders gesagt: Die automatische Erkennung des Wurzeldateisystems und die der anderen Dateisysteme sind voneinander unabhangige Aktionen, die wahrend zwei klar voneinander abgegrenzter Phasen des Systemstartprozesses stattfinden (einer in der Initrd, einer in der anschliessenden Phase). Diese Partitionen werden auf Systemen nicht gesucht, bei denen das Wurzeldateisystem uber mehrere Platten verteilt ist, beispielweise mittels btrfs RAID. Die Wurzelpartition kann explizit durch Symlinken von /run/systemd/volatile-root nach /dev/block/$major:$minor konfiguriert werden. Dies ist insbesondere nutzlich, falls die Wurzeleinhangung durch irgendeine Art von fluchtigem Dateisystem (Overlayfs) ersetzt wurde. Systemd-gpt-auto-generator ist fur die Zentralisierung der Dateisystemkonfiguration in der Partitionstabelle nutzlich und macht Konfiguration in /etc/fstab oder auf der Kernelbefehlszeile unnotig. Dieser Generator sucht Partitionen basierend auf ihrer Partitionstyp-GUID. Die nachfolgenden Partitionstyp-GUIDs werden identifiziert: Tabelle 1. Partitionstyp-GUIDs +------------------------+--------------------------------------+------------------------------+-----------------+----------------------+ |Partitionstyp | GUID | Name | Einhangepunkt | Erklarung | +------------------------+--------------------------------------+------------------------------+-----------------+----------------------+ |SD_GPT_ROOT_X86_64 | 4f68bce3-e8cd-4db1-96e7-fbcaf984b709 | Wurzelpartition (x86-64) | / | Die erste Partition | | | | | | 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 (64-bit ARM) | / | Die erste Partition | | | | | | 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 fur andere | / | Die erste Partition | |SD_GPT_ROOT_ARC | | Architekturen | | mit dieser Art von | |SD_GPT_ROOT_ARM | | | | 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 finden | |SD_GPT_ROOT_PPC | | | | eine vollstandige | |SD_GPT_ROOT_PPC64 | | | | Liste und die Werte | |SD_GPT_ROOT_PPC64_LE | | | | der Konstanten in | |SD_GPT_ROOT_RISCV32 | | | | der | |SD_GPT_ROOT_RISCV64 | | | | UAPI.2-Spezifikation | |SD_GPT_ROOT_S390 | | | | fur 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/ | | | | | | eingehangt. | +------------------------+--------------------------------------+------------------------------+-----------------+----------------------+ |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/ | | | | | | eingehangt. | +------------------------+--------------------------------------+------------------------------+-----------------+----------------------+ |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/ | | | | | | eingehangt - | | | | | | 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 | Temporare-Daten-Partition | /var/tmp/ | Die erste Partition | | | | | | mit dieser Art von | | | | | | UUID auf der | | | | | | gleichen Platte wie | | | | | | die Wurzelpartition | | | | | | wird als /var/tmp/ | | | | | | eingehangt. | +------------------------+--------------------------------------+------------------------------+-----------------+----------------------+ |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 | Die erste Partition | | | | | /boot/ | mit dieser Art von | | | | | | UUID auf der | | | | | | gleichen Platte wie | | | | | | die Wurzelpartition | | | | | | wird als /boot/ oder | | | | | | /efi/ eingehangt, | | | | | | 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/ | | | | | | eingehangt, siehe | | | | | | unten. | +------------------------+--------------------------------------+------------------------------+-----------------+----------------------+ Dieser Generator versteht die folgenden Attributschalter fur Partitionen: Tabelle 2. Partitionsattributsschalter +---------------------------------+--------------------+---------------------+--------------------+ |Schalter | Wert | anwendbar auf | Erklarung | +---------------------------------+--------------------+---------------------+--------------------+ |SD_GPT_FLAG_READ_ONLY | 0x1000000000000000 | /, /home/, /srv/, | Partition ist | | | | /var/, /var/tmp/, | schreibgeschutzt | | | | >>Extended Boot | eingehangt | | | | Loader<<-Partition | | +---------------------------------+--------------------+---------------------+--------------------+ |SD_GPT_FLAG_NO_AUTO | 0x8000000000000000 | /, /home/, /srv/, | Partition wird | | | | /var/, /var/tmp/, | nicht automatisch | | | | >>Extended Boot | eingehangt | | | | Loader<<-Partition | | +---------------------------------+--------------------+---------------------+--------------------+ |SD_GPT_FLAG_NO_BLOCK_IO_PROTOCOL | 0x0000000000000002 | EFI-Systempartition | Partition wird | | | | (ESP) | nicht automatisch | | | | | eingehangt | +---------------------------------+--------------------+---------------------+--------------------+ Die Partitionen /home/, /srv/, /var/, /var/tmp/ und fur Auslagerung konnen im LUKS-Format verschlusselt sein. In diesem Fall wird ein Device-Mapper-Gerat 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 konnte, falls die gleiche Partition in /etc/crypttab mit einem anderen Device-Mapper-Geratenamen eingetragen ist. Wenn Systemd in der Initrd lauft, kann die Partition / auch mit LUKS verschlusselt sein. In diesem Fall wird ein Device-Mapper-Gerat unter dem Namen /dev/mapper/root eingerichtet und ein sysroot.mount wird eingerichtet, das das Gerat unter /sysroot einhangt. Fur weitere Informationen siehe bootup(7). Auf EFI-Systemen werden Einhange- und Autoumount-Units fur die EFI-Systempartition (ESP) und Erweiterte Systemstartladepartitionen (XBOOTLDR) erstellt. Falls die Platte eine XBOOTLDR-Partition enthalt, wie sie in der UAPI.1-Systemstartladerspezifikation[4] definiert ist, wird diese unter /boot/ zur Verfugung gestellt. Dieser Generator erstellt eine Automount-Unit; die Einhangung wird nur bedarfsgesteuert beim Zugriff aktiviert. Falls notwendig wird der Einhangepunkt erstellt. Der ESP wird unter /boot/ eingehangt, falls das Verzeichnis existiert und nicht fur XBOOTLDR genutzt wird, andernfalls unter /efi/. Genau wie bei /boot/ wird eine Automount-Unit verwandt. Falls notwendig wird der Einhangepunkt erstellt. Fur Einhangepunkte, 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 Teildatentrager (Subvolumes) setzen.. Falls das System uber systemd-stub(7) gestartet wurde und der Rumpf dem Anwendungsraum meldete, dass das Kernelabbild in ein TPM2-PCR eingemessen wurde, dann werden alle ermittelten Datentragerkennzeichnungen fur root und /var/ (und Datentragerverschlusselungsschlussel, falls sie verschlusselt sind) automatisch in PCR 15 bei der Akivierung uber systemd-pcrfs@.service(8) eingemessen. Einhange-beschrankende Metadaten, die im Dateisystem enthalten sind, werden durch das Hereinziehen von systemd-validatefs@.service(8) fur erstellte Einhangungen validiert. 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 standardmassig >>yes<<. Der Generator wird standardmassig aktiviert und ein false-Wert kann zu seiner Deaktivierung verwandt werden (z.B. >>systemd.gpt_auto=0<<). Hinzugefugt in Version 242. systemd.image_policy= Akzeptiert eine Abbildanalyse-Richtlinienzeichenkette als Argument (gemass systemd.image-policy(7)) und erlaubt das Durchsetzen einer Richtlinie bei der Analyse und die Verwendung der automatisch erkannten GPT-Partitionstabelleneintrage. Beachten Sie, dass die angegebenen Plattenrichtlinie fur automatische Wurzel- oder /usr/-Dateisystemerkennung nicht berucksichtigt wird, ausser wenn root=dissect/mount.usr=dissect (oder root=dissect-force) angegeben sind. (Die Richtlinie wird fur die anderen automatisch erkannten Partitionstypen immer angewandt.) Hinzugefugt in Version 254. systemd.image_filter= Akzeptiert eine Abbildanalyse-Filterzeichenkette als Argument (gemass systemd.image-filter(7)) und erlaubt das Durchsetzen einer Reihe von Globbing-Muster auf dem Partitions-Abgleich der automatisch erkannten GPT-Partitionstabelleneintrage. Beachten Sie, dass der angegebene Abbildfilter bei der automatischen Erkennung des Wurzel- oder /usr/-Dateisystems nicht berucksichtigt wird, ausser root=dissect/mount.usr=dissect (oder root=dissect-force) sind angegeben. (Der Filter wird immer bei den anderen automatisch erkennbaren Partitionstypen angewandt.) Hinzugefugt in Version 258. root=, rootfstype=, rootflags= Wird root= mit dem besonderen Wert >>gpt-auto<< verwandt, dann wird die grundlegende automatische Erkennung der Wurzelpartition, basierend auf dem GPT-Partitionstyp, aktiviert. Die Verwendung der Wurzelpartition wird verzogert, bis der Werkseinstellungsmodus verlassen wurde, falls er wahrend des aktuellen Systemstarts aktiviert ist. Weitere Informationen dazu finden Sie in Werkseinstellung[5]. Falls >>gpt-auto-force<< angegeben ist, wird die automatische Erkenung von Wurzelpartitionen aktiviert und der alle Werkseinstellungsmodi werden ignoriert. Falls root= auf den besondern Wert >>dissect<< gesetzt ist, wird die vollstandig automatische Erkennung der Wurzelpartition, basierend auf der GPT-Partitionsinformation, aktiviert. Dies ist eine Obermenge von root=gpt-auto, da es automatisch Verity-Partitionen, einschliesslich Signatur-basierter Installationen, konfiguriert. Dabei wird der in UAPI.2-Spezifikation fur auffindbare Partitionen[6] definierten Logik gefolgt. Desweiteren berucksichtigt sie fur alle Partitionstypen die konfigurierte Abbild-Richtlinie und den Abbildfilter, einschliesslich des Wurzeldateisystems. >>root=dissect<< wartet auf den Abschluss der Werkeinstellungsphase, falls sie aktiviert ist, bevor das Wurzeldateisystem aktiviert wird. Verwenden Sie >>root=dissect-force<<, um die Werkeinstellungsphase zu ignorieren und das Wurzeldateisystem sofort zu aktivieren. Jeder andere Wert (d.h. ausser >>gpt-auto<<, >>gpt-auto-force<<, >>dissect<<, >>dissect-force<<) deaktiviert die automatische Erkennung des Wurzeldateisystems. Falls root= uberhaupt nicht auf der Kernelbefehlszeile angegeben ist, wird die automatische Erkennung der Wurzelpartition mittels des ESPs, wie er vom Systemstartprogramm berichtet wird, auch aktiviert (dabei wird der Werkseinstellungs-Zurucksetz-Zustand berucksichtigt, d.h. aquivalent zu >>root=gpt-auto<<). Allerdings wird in diesem Fall die auf dem Loopback-Block-Gerat-Feld >>.lo_name<< basierende Erkennung nicht aktiviert. Die Optionen rootfstype= und rootflags= werden zur Auswahl des Dateisystemtyps und der Optionen verwandt, wenn das Wurzeldateisystem automatisch ermittelt wird. Hinzugefugt in Version 242. mount.usr=, mount.usrfstype=, mount.usrflags= Ahnlich zu root=, rootfstype=, rootflags= (siehe oben), gilt aber stattdessen fur die Partition /usr/. Beachten Sie, dass die Einstellungen >>gpt-auto<<, >>gpt-auto-force<<, >>dissect-force<<, die fur root= ausgewertet werden, nicht durch mount.usr= unterstutzt werden (allerdings wird >>dissect<< unterstutzt). Beachten Sie auch, dass die automatische Erkennung von Partitionen fur /usr/ explizit aktiviert werden muss, anders als die Erkennung fur das Wurzeldateisystem, die aktiviert wird, falls uberhaupt kein Parameter root= hereingereicht wird. Hinzugefugt in Version 258. rw, ro Hangt die Wurzelpartition anfanglich les-schreibbar oder nur lesbar ein. Beachten Sie, dass anders als bei den meisten Kernelbefehlszeilenoptionen diese Einstellungen nicht die Konfigurationen im Dateisystem ausser Kraft setzen und das Dateisystem spater neu eingehangt werden konnte. Siehe systemd-remount-fs.service(8). Hinzugefugt 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. Standardmassig aktiviert. Hinzugefugt 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), systemd-validatefs@.service(8), machine-id(5), cryptsetup(8), fstab(5), btrfs(8) ANMERKUNGEN 1. UEFI-Spezifikation https://uefi.org/specifications 2. UAPI.2-Spezifikation fur auffindbare Partitionen https://uapi-group.org/specifications/specs/discoverable_partitions_specification 3. Systemstartlader-Schnittstelle https://systemd.io/BOOT_LOADER_INTERFACE 4. UAPI.1-Systemstartladerspezifikation https://uapi-group.org/specifications/specs/boot_loader_specification 5. Werkseinstellung https://systemd.io/FACTORY_RESET 6. UAPI.2-Spezifikation fur auffindbare Partitionen https://uapi-group.org/specifications/specs/discoverable_partitions_specification/ UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer: . systemd 259.1 SYSTEMD-GPT-AUTO-GENERATOR(8)