.\" -*- coding: UTF-8 -*- '\" t .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH SYSTEMD\-IMPORT\-GENERATOR 8 "" "systemd 260.1" systemd\-import\-generator .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\-import\-generator \- Generator zum automatischen Herunterladen von Plattenabbildern beim Systemstart .SH ÜBERSICHT .PP /usr/lib/systemd/system\-generators/systemd\-import\-generator .SH BESCHREIBUNG .PP \fBsystemd\-import\-generator\fP kann zum automatischen Herunterladen von Plattenabbildern (Tarbällen oder DDIs) mittels \fBsystemd\-importd.service\fP(8) beim Systemstart verwandt werden, basierend auf Parametern auf der Kernelbefehlszeile oder mittels Systemzugangsberechtigungen\&. Dies ist zum automatischen Einsatz bei \fBsystemd\-confext\fP(8)\-, \fBsystemd\-sysext\fP(8)\-, \fBsystemd\-nspawn\fP(1)/ \fBsystemd\-vmspawn\fP(1)\- oder \fBsystemd\-portabled.service\fP(8)\-Abbildern beim Systemstart nützlich\&. Dies stellt Funktionalität äquivalent zu \fBimportctl\fP(1) bereit, auf sie kann aber mittels Kernelbefehlszeile und Systemzugangsberechtigungen zugegriffen werden\&. .PP systemd\-import\-generator implementiert \fBsystemd.generator\fP(7)\&. .SH KERNEL\-BEFEHLSZEILE .PP systemd\-import\-generator versteht die nachfolgenden \fBkernel\-command\-line\fP(7)\-Parameter: .PP \fIsystemd\&.pull=\fP .RS 4 Diese Option akzeptiert ein durch Doppelpunkte getrenntes Tripplet von Optionszeichenkette, lokalen Zielabbildnamen und ferner URL\&. Der lokale Zielabbildname kann durch eine leere Zeichenkette festgelegt werden; in diesem Fall wird der Name aus der angegebenen fernen URL abgeleitet\&. Die ferne URL muss eines der Schemata »http://«, »https://«, »file://« nutzen\&. Die Optionszeichenkette selbst ist eine Kommata\-getrennte Liste von Optionen: .PP rw, ro .RS 4 Steuert, ob das lokale Abbild als schreibgeschützt markiert werden soll\&. Falls nicht angegeben, ist die Vorgabe für den Schreibschutz aus\&. .sp Hinzugefügt in Version 257\&. .RE .PP verify= .RS 4 Steuert, ob der Download kryptographisch validiert werden soll, bevor er in situ installiert wird\&. Akzeptiert entweder »no«, »checksum« oder »signature« (die Vorgabe, falls nicht angegeben)\&. Zu Details siehe \fB\-\-verify=\fP von \fBimportctl\fP(1)\&. .sp Hinzugefügt in Version 257\&. .RE .PP sysext, confext, machine, portable .RS 4 Steuert die zu herunterladende Abbildklasse und damit letztendlich das Zielverzeichnis für das Abbild\&. Abhängig von dieser Wahl wird das Zielverzeichnis var/lib/extensions/, /var/lib/confexts/, /var/lib/machines/ oder /var/lib/portables/ ausgewählt\&. .sp Es muss genau eine dieser Optionen angegeben werden\&. .sp Hinzugefügt in Version 257\&. .RE .PP tar, raw .RS 4 Steuert den Typ der herunterzuladenen Ressource, d\&.h\&. einen (möglicherweise komprimierten) Tarball, der in einen Dateisystembaum entpackt werden muss oder ein (möglicherweise komprimiertes) rohes Plattenabbild (DDI)\&. .sp Es muss genau eine dieser Optionen angegeben werden\&. .sp Hinzugefügt in Version 257\&. .RE .PP blockdev .RS 4 Falls diese Option angegeben ist, wird das heruntergeladene Abbild nach Abschluss an das Loopback\-Blockgerät angehängt (mittels systemd\-loop@\&.service)\&. Dies erlaubt den Systemstart von heruntergeladenen Plattenabbildern\&. Dies wird nur für »rohe« Plattenabbilder unterstützt\&. .sp Wenn diese Option mit dem Zweck des Einhängens eines Plattenabbildes, das der \m[blue]\fBUAPI.3\-Spezifikation für auffindbare Plattenabbilder\fP\m[]\&\s-2\u[1]\d\s+2 folgt, als Wurzeldateisystem verwandt wird und die automatische GPT\-Partitionserkennungslogik, wie sie durch \fBsystemd\-gpt\-auto\-generator\fP(8) implementiert ist, es verarbeiten soll, dann ist die Angabe von »rootdisk« als lokalen Namen für den Import wichtig\&. Desweiteren muss »root=gpt\-auto« auf der Kernelbefehlszeile explizit angegeben werden\&. Auch muss der Befehlszeilenoption »systemd\&.pull=« »rd\&.« vorangestellt werden, um sicherzustellen, dass sie bereits in der anfänglichen RAM\-Platte (Initrd) ausgeführt wird, siehe auch unten\&. .sp Hinzugefügt in Version 258\&. .RE .PP bootorigin .RS 4 Falls diese Option angegeben ist, kann anstatt der URL ein einfacher Dateiname angegeben werden\&. Falls das System mittel UEFI\-HTTP\-Netzwerk\-Systemstart gestartet wird, wird die letzte Komponente der Netzwerk\-Systemstart\-Ursprungs\-URL durch diesen Dateinamen ersetzt und als heruntergeladene Quelle betrachtet\&. Dies erlaubt es damit, die URLs für Plattenabbilder automatisch aus den ursprünglichen Systemstart\-URLs abzuleiten, die zum Aufruf des Kernels oder des Systemstartprogramms verwandt werden\&. .sp Falls diese Option angegeben ist und das System nicht wirklich mittels UEFI\-HTTP\-Netzwerk\-Systemstart gestartet wird, wird das Herunterladen ohne Probleme übersprungen\&. Mit anderen Worten gesagt, ist es ohne weitere Veränderungen möglich, ein Initrd\-Abbild zusammenzustellen, das von einer lokalen Platte startet, falls diese verfügbar ist, oder von einem heruntergeladenen Plattenabbild, falls es über Netzwerk\-Systemstart verwandt wird\&. .sp Hinzugefügt in Version 258\&. .RE .PP runtime= .RS 4 Akzeptiert ein logisches Argument\&. Falls auf true gesetzt, wird das Abbild unterhalb der Hierarchie /run/ heruntergeladen und falls auf false gesetzt, unterhalb der Hierarchie /var/lib/\&. Falls nicht angegeben, ist die Vorgabe true in der anfänglichen RAM\-Platte (Initrd) und false auf dem Hauptsystem\&. .sp Hinzugefügt in Version 258\&. .RE .sp Hinzugefügt in Version 257\&. .RE .PP \fIsystemd\&.pull\&.success_action=\fP, \fIsystemd\&.pull\&.failure_action=\fP .RS 4 Steuert, ob eine Aktion wie reboot, power\-off und ähnliches nach erfolgreichem oder nicht erfolgreichem Abschluss des Herunterladens ausgeführt werden soll\&. Siehe \fISuccessAction=\fP/\fIFailureAction=\fP für \fBsystemd.unit\fP(5) zu Details über die möglichen Aktionen\&. Falls nicht angegeben, erfolgt keine Aktion und das System wird ganz normal mit dem Systemstart fortfahren\&. .sp Hinzugefügt in Version 257\&. .RE .PP Diese Kernelbefehlszeilenoptionen werden nur auf dem Hauptsystem ausgewertet\&. Falls diesen Optionen »rd\&.« vorangestellt werden, werden sie stattdessen durch die anfängliche RAM\-Platte (Initrd) interpretiert\&. .SH ZUGANGSBERECHTIGUNGEN .PP \fBsystemd\-import\-generator\fP unterstützt die Logik der Systemzugangsberechtigungen\&. Die folgenden Berechtigungen werden verwandt, wenn sie hereingereicht werden: .PP \fIimport\&.pull\fP .RS 4 Diese Zugangsberechtigung sollte eine Textdatei sein, wobei jede Zeile eine Herunterladeaktion referenziert\&. Jede Zeile sollte das gleiche Format wie der Wert der oben beschriebenen Kernelbefehlszeile \fIsystemd\&.pull=\fP haben\&. .sp Hinzugefügt in Version 257\&. .RE .SH BEISPIELE .PP \fBBeispiel\ \&1.\ \&Konfigurationserweiterungen herunterladen\fP .sp .if n \{\ .RS 4 .\} .nf systemd\&.pull=raw,confext::https://example\&.com/meinconfext\&.raw\&.gz .fi .if n \{\ .RE .\} .PP Mit einer Kernelbefehlszeilenoption ähnlich der obigen wird ein Konfigurationserweiterungs\-DDI automatisch beim Systemstart von der angegebenen URL heruntergeladen, kryptographisch validiert, dekomprimiert und installiert\&. .PP \fBBeispiel\ \&2.\ \&Systemerweiterungen herunterladen (ohne Validierung)\fP .sp .if n \{\ .RS 4 .\} .nf systemd\&.pull=tar,sysext,verify=no::https://example\&.com/meinsysext\&.tar\&.gz .fi .if n \{\ .RE .\} .PP Mit einer Kernelbefehlszeilenoption ähnlich der obigen wird beim Systemstart automatisch ein Systemerweiterungs\-Tarball von der angegebenen URL heruntergeladen, dekomprimiert und installiert \(en ohne kryptographische Validierung\&. Dies ist zu Entwicklungszwecken in virtuellen Maschinen und Containern nützlich\&. Warnung: Setzen Sie kein System mit auf dieser Art deaktivierter Validierung ein! .PP \fBBeispiel\ \&1.\ \&Herunterladen eines Wurzelplattenabbildes (roh) in den Speicher, um darein zu starten\fP .sp .if n \{\ .RS 4 .\} .nf rd\&.systemd\&.pull=raw,machine,verify=no,blockdev:image:https://example\&.com/image\&.raw\&.xz root=/dev/disk/by\-loop\-ref/image\&.raw\-part2 .fi .if n \{\ .RE .\} .PP Dies lädt das angegebene Plattenabbild herunter, speichert es lokal unter dem Namen »image« und hängt es an das Loopback\-Blockgerät nach Abschluss an\&. Es startet dann von der zweiten Partition im Abbild\&. .PP \fBBeispiel\ \&4.\ \&Starten in ein Plattenabbild (roh), mit einer URL, die aus UEFI\-HTTP\-Netzwerk\-Systemstarten abgeleitet ist\fP .sp .if n \{\ .RS 4 .\} .nf rd\&.systemd\&.pull=raw,machine,verify=no,blockdev,bootorigin:rootdisk:image\&.raw\&.xz root=gpt\-auto .fi .if n \{\ .RE .\} .PP Dies ist ähnlich zum vorherigen Beispiel, aber diesmal wird die Quell\-URL automatisch aus der UEFI\-HTTP\-Netzwerk\-Systemstart\-URL abgeleitet\&. Wird beispielsweise ein UKI aus einer URL »http://example\&.com/image\&.efi« gestartet, würde dies dazu führen, dass eine Wurzelplatte aus »http://example\&.com/image\&.raw\&.xz« heruntergeladen würde\&. Desweiteren verwendet es die \fBsystemd\-gpt\-auto\-generator\fP(8)\-Logik, um das Wurzeldateisystem aus dem Platenabbild einzuhängen\&. .PP \fBBeispiel\ \&5.\ \&Starten in ein Plattenabbild (tar), mit einer URL, die aus UEFI\-HTTP\-Netzwerk\-Systemstarten abgeleitet ist\fP .sp .if n \{\ .RS 4 .\} .nf rd\&.systemd\&.pull=tar,machine,verify=no,bootorigin:root:image\&.tar\&.xz root=bind:/run/machines/root .fi .if n \{\ .RE .\} .PP Dies ist ähnlich zum vorherigen Beispiel, aber statt eines rohen (d\&.h\&. Blockgeräte\-basierenden) Plattenabbildes startet das System in einen Tarball, der vom dem Quell\-UEFI\-Netzwerkserver heruntergeladen wird\&. .SH "SIEHE AUCH" .PP \fBsystemd\fP(1), \fBsystemd\-importd.service\fP(8), \fBkernel\-command\-line\fP(7), \fBsystemd.system\-credentials\fP(7), \fBimportctl\fP(1), \fBsystemd\-loop@.service\fP(8), \fBsystemd\-gpt\-auto\-generator\fP(8) .SH ANMERKUNGEN .IP " 1." 4 UAPI.3\-Spezifikation für auffindbare Plattenabbilder .RS 4 \%https://uapi\-group.org/specifications/specs/discoverable_disk_image/ .RE .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann 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 .