kernel-install

BEZEICHNUNG

kernel-install - Fügt Kernel und Initrd-Images zu /boot hinzu und entfernt sie von dort

ÜBERSICHT

BESCHREIBUNG

kernel-install wird dazu verwandt, Kernel und Initrd-Images [1] in die Bootloader-Partition zu installieren und sie von dort wieder zu entfernen. Dies wird hier mit $BOOT referenziert. Normalerweise ist es entweder /boot/, /efi/ oder /boot/efi/, siehe unten. kernel-install führt die im Verzeichnis /usr/lib/kernel/install.d/ und dem lokalen Administratorverzeichnis /etc/kernel/install.d/ befindlichen ausführbaren Dateien (»Erweiterungen«) aus. Alle Dateien werden gemeinsam sortiert und in lexikalischer Reihenfolge ausgeführt, unabhängig davon, in welchem Verzeichnis sie sich befinden. Allerdings ersetzen Dateien mit gleichem Dateinamen einander. Dateien in /etc/kernel/install.d/ haben gegenüber Dateien mit dem gleichen Namen in /usr/lib/kernel/install.d/ Vorrang. Dies kann dazu benutzt werden, um bei Bedarf vom System bereitgestellte Programme mit einer lokalen Datei außer Kraft zu setzen. Ein symbolischer Link in /etc/kernel/install.d/ auf /dev/null mit dem gleichen Namen wie das Programm in /usr/lib/kernel/install.d/ deaktiviert das Programm komplett. Programme müssen die Erweiterung ».install« tragen, andere Erweiterungen werden ignoriert. Ein in diesen Verzeichnissen abgelegtes Programm sollte im Erfolgsfall 0 zurückliefern. Es darf auch 77 zurückliefern, womit die gesamte Aktion beendet wird (Programme später in der lexikalischen Reihenfolge werden übersprungen).

BEFEHLE

Die folgenden Befehle werden verstanden: add KERNEL-VERSION KERNEL-ABBILD [INITRD-DATEI …] remove KERNEL-VERSION inspect

DIE PARTITION »$BOOT«

Die Partition, in der die Kernel und die Schnipsel der Bootloader-Spezifikation[2] liegen, wird $BOOT genannt. kernel-install bestimmt den Ort dieser Partition durch Überprüfung von nacheinander /efi/, /boot/ und /boot/efi/. Der erste Ort, an dem $BOOT/loader/entries/ oder $BOOT/ ZUGANGSMERKMAL/ existiert, wird verwandt.

OPTIONEN

Die folgenden Optionen werden verstanden: -v, --verbose -h, --help --version

UMGEBUNGSVARIABLEN

Für Erweiterungen exportierte Umgebungsvariablen

Es wird $KERNEL_INSTALL_VERBOSE=1 für Erweiterungen exportiert, falls --verbose verwandt wird. Sie können in diesem Fall zusätzliche Protokollmeldungen ausgeben. $KERNEL_INSTALL_MACHINE_ID wird für die Erweiterungen auf die gewünschte zu verwendende Maschinenkennung gesetzt. Es ist immer eine 128-bit-Kennung. Normalerweise wird sie aus /etc/machine-id ausgelesen, aber das kann auch mittels $MACHINE_ID außer Kraft gesetzt werden (siehe unten). Falls nicht über eine diese Methoden festgelegt, wird der Rückfallwert durch kernel-install erstellt und nur für einen einzelnen Aufruf verwandt werden. $KERNEL_INSTALL_ENTRY_TOKEN wird für Erweiterungen auf das gewünschte, zu verwendene Zugangs-»Merkmal« gesetzt. Es ist ein Kennzeichner, der zur Identifizierung der lokalen Installation verwandt wird und oft die Maschinenkennung ist, dh. identisch zu $KERNEL_INSTALL_MACHINE_ID. Es kann aber auch eine andere Art von Kennzeichner sein, beispielsweise eine feste Zeichenkette oder die Werte ID=, IMAGE_ID= aus /etc/os-release. Die hier übergebene Zeichenkette wird dazu verwandt, die Systemlader-Spezifikationseinträge zu benennen oder die Verzeichnisse, in die das Kernelabbild und die anfänglichen RAM-Plattenabbilder abgelegt werden. Beachten Sie, dass oft $KERNEL_INSTALL_ENTRY_TOKEN und $KERNEL_INSTALL_MACHINE_ID auf die gleichen Werte gesetzt werden, aber der erste Wert eine beliebige kurze Zeichenkette sein kann, während letzterer garantiert eine gültige 32-Zeichen-Kennung in kleingeschriebener hexadezimaler Form ist. Das zu verwendende Zugangsmerkmal wird aus /etc/kernel/entry-token gelesen, falls diese existiert. Andernfalls werden einige mögliche Kandidaten unterhalb von $BOOT auf Systemlader-Spezifikation-Typ-1-Zugangsverzeichnisse überprüft und, falls diese gefunden werden, daraus das Zugangsmerkmal abgeleitet wird. Falls das nicht erfolgreich ist, wird $KERNEL_INSTALL_MACHINE_ID als Rückfalloption verwandt. KERNEL_INSTALL_BOOT_ROOT= wird für die Erweiterungen auf den absoluten Pfad des Wurzelverzeichnisses (normalerweise den Einhängepunkt) der Hierarchie gesetzt, in der Systemstartprogramm-Einträge, Kernel-Abbilder und zugehörige Ressourcen abgelegt werden sollen. Dies ist normalerweise der Pfad, auf dem die XBOOTLDR-Partition oder die ESP (EFI-Systempartition) eingehängt sind. Dieser kann konzeptionell auch mittels $BOOT referenziert werden. Kann mit BOOT_ROOT außer Kraft gesetzt werden (siehe unten). KERNEL_INSTALL_LAYOUT=bls|other|… wird für die Erweiterungen zur Angabe des Installationslayouts festgelegt. Standardmäßig bls, falls $BOOT/ ZUGANGSMERKMAL existiert oder ansonsten other. Per Konvention können zusätzliche Layoutnamen definiert sein. Falls eine Erweiterung ein bestimmtes Layout verwendet, wird empfohlen, dass ein eigener Layoutname erklärt und layout= während der Installation in install.conf konfiguriert wird. Die folgenden Werte werden derzeit verstanden: bls other $KERNEL_INSTALL_INITRD_GENERATOR ist für Erweiterungen gesetzt, um den Initrd-Generator auszuwählen. Dies kann über initrd_generator= in install.conf konfiguriert werden, siehe unten. $KERNEL_INSTALL_STAGING_AREA ist für Erweiterungen auf einen Pfad zu einem Verzeichnis gesetzt. Erweiterungen können Ergänzungsdateien in diesem Verzeichnis sein und sie werden als Teil des Lader-Zugangs installiert, basierend auf dem Dateinamen und der Erweiterung.

Von Kernel-install verstandene Umgebungsvariablen

$KERNEL_INSTALL_CONF_ROOT kann gesetzt werden, um den Ort der von kernel-install gelesenen Konfigurationsdateien außer Kraft zu setzen. Wenn gesetzt, werden install.conf, entry-token und andere Dateien aus diesem Verzeichnis gelesen. $KERNEL_INSTALL_PLUGINS kann gesetzt werden, um die Liste der von kernel-install ausgeführten Erweiterungen außer Kraft zu setzen. Das Argument ist eine Lerraum-getrennte Liste von Pfaden. Mit »KERNEL_INSTALL_PLUGINS=:« kann erreicht werden, dass keine Erweiterung ausgeführt wird. $MACHINE_ID kann gesetzt werden, damit kernel-install $KERNEL_INSTALL_MACHINE_ID, die Maschinenkennung, außer Kraft setzt. $BOOT_ROOT kann gesetzt werden, damit kernel-install $KERNEL_INSTALL_BOOT_ROOT, der Installationsort für Systemstarteinträge, außer Kraft setzt. Die letzten zwei Variablen können auch in install.conf gesetzt werden. In der Umgebung gesetzte Variablen haben Vorrang vor in Konfigurationsdateien gesetzten Werten.

EXIT-STATUS

Falls alle Programme 0 oder 77 zurückliefern, wird 0 zurückgeliefert, andernfalls ein von Null verschiedener Fehlercode.

DATEIEN

/usr/lib/kernel/install.d/*.install /etc/kernel/install.d/*.install /usr/lib/kernel/cmdline /etc/kernel/cmdline /proc/cmdline /etc/kernel/tries /etc/kernel/entry-token /etc/machine-id /etc/os-release /usr/lib/os-release /usr/lib/kernel/install.conf /etc/kernel/install.conf

SIEHE AUCH

machine-id(5), os-release(5), depmod(8), systemd-boot(7), Systemstartladeprogrammspezifikation[2]

ANMERKUNGEN

1.

Heutzutage werden tatsächlich CPIO-Archive als »initramfs« statt einer »initrd« verwandt. Siehe bootup(7) für eine Erläuterung.

2.

Systemladerspezifikation

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <[email protected]> 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