KERNEL-IMG.CONF(5)

BEZEICHNUNG
kernel-img.conf - Konfigurationsdatei für Linux-Kernel-Image-Pakete

ÜBERSICHT
/etc/kernel-img.conf

BESCHREIBUNG
The file /etc/kernel-img.conf is used by the kernel package installation and removal process to allow local options for handling some aspects of the installation. Most configuration variables apply only to kernel image packages.

Not all kernel image package creators support this file, or all the configuration variables. Support status for the file itself is:
Package creator | Status
Debian linux source package | supported
Ubuntu linux source package | supported
kernel-package | supported
make deb-pkg | ignored

Das Format der Datei ist ein einfaches Paar VAR = WERT. Boole'sche Werte können als Yes, True, 1 und No, False, 0 angegeben werden und berücksichtigen keine Groß-/Kleinschreibung. Diese Datei wird unter bestimmten Umständen automatisch durch das Installationsskript erstellt.

Momentan werden folgende vom Benutzer veränderbaren Variablen unterstützt:

do_symlinks
    If set, the postinst and postrm scripts will maintain symlinks to default kernel and initramfs images, as described in linux-update-symlinks(8). This variable is set by default.
    Package creator | Status
    Debian linux source package | supported
    Ubuntu linux source package | supported
    kernel-package | ignored since v12.001;
     | previously supported

image_dest
    Set this variable to the directory in which symlinks to the default kernel and initramfs images should be maintained. The default value is /.
    Package creator | Status
    Debian linux source package | supported
    Ubuntu linux source package | supported
    kernel-package | ignored since v12.001;
     | previously supported

link_in_boot
    If set, this has the same effect as image_dest = /boot and overrides any other setting of image_dest. This variable is unset by default.
    Package creator | Status
    Debian linux source package | supported
    Ubuntu linux source package | supported
    kernel-package | ignored since v12.001;
     | previously supported

postinst_hook
    DEPRECATED: Set this variable to a script to be executed during installation. The path can be a relative path if the script lives in a safe path -- that is, if it lives in /bin, /sbin, /usr/bin, or /usr/sbin, or must be an absolute path instead. Before calling this script, the environment variable STEM shall be set to the value of the --stem argument (or the default value, linux), and in packages created by kernel-package KERNEL_PACKAGE_VERSION shall be set to the version of the kernel-package that created the package. This script shall be called with two arguments, the first being the version of the kernel image, and the second argument being the location of the kernel image itself. Errors in the script shall cause the postinst to fail. Since debconf is in use before the script is called, this script should issue no diagnostic messages to stdout -- while the postinst does call db_stop, debconf does not restore stdout, so messages to stdout disappear. An example script for grub users is present in /usr/share/doc/kernel-package/ directory. This script is run after the scripts in /etc/kernel/postinst.d directory.
    Package creator | Status
    Debian linux source package | unsupported since v4.6.1-1;
     | previously supported
    Ubuntu linux source package | unsupported since v4.15.0-18.19;
     | previously supported
    kernel-package | deprecated

postrm_hook
    DEPRECATED: Set this variable to a script to be executed in the postrm (that is, after the image has been removed) after all the remove actions have been performed. The path can be a relative path if the script lives in a safe path -- that is, if it lives in /bin, /sbin, /usr/bin, or /usr/sbin, or must be an absolute path instead. In packages created by kernel-package, the environment variable KERNEL_PACKAGE_VERSION shall be set to the version of the kernel-package that created the package. This script shall be called with two arguments, the first being the version of the kernel image, and the second argument being the location of the kernel image itself. Errors in the script shall produce a warning message, but shall be otherwise ignored. Since debconf is in use before the script is called, this script should issue no diagnostic messages to stdout -- while the postinst does call db_stop, debconf does not restore stdout, so messages to stdout disappear. This script is run after the scripts in /etc/kernel/postrm.d directory.
    Package creator | Status
    Debian linux source package | unsupported since v4.6.1-1;
     | previously supported
    Ubuntu linux source package | unsupported since v4.15.0-18.19;
     | previously supported
    kernel-package | deprecated

preinst_hook
    DEPRECATED: Set this variable to a script to be executed before the package is unpacked, and can be used to put in additional checks. The path can be a relative path if the script lives in a safe path -- that is, if it lives in /bin, /sbin, /usr/bin, or /usr/sbin, or must be an absolute path instead. In packages created by kernel-package, the environment variable KERNEL_PACKAGE_VERSION shall be set to the version of the kernel-package that created the package. This script shall be called with two arguments, the first being the version of the kernel image, and the second argument being the location of the kernel image itself. This script is run after the scripts in /etc/kernel/preinst.d directory.
    Package creator | Status
    Debian linux source package | unsupported since v4.6.1-1;
     | previously supported
    Ubuntu linux source package | unsupported since v4.15.0-18.19;
     | previously supported
    kernel-package | deprecated

prerm_hook
    DEPRECATED: Set this variable to a script to be executed before the package files are removed (so any added files may be removed) . The path can be a relative path if the script lives in a safe path -- that is, if it lives in /bin, /sbin, /usr/bin, or /usr/sbin, or must be an absolute path instead. In packages created by kernel-package, the environment variable KERNEL_PACKAGE_VERSION shall be set to the version of the kernel-package that created the package. This script shall be called with two arguments, the first being the version of the kernel image, and the second argument being the location of the kernel image itself. Errors in the script shall cause the prerm to fail. Since debconf is in use before the script is called, this script should issue no diagnostic messages to stdout -- while the postinst does call db_stop, debconf does not restore stdout, so messages to stdout disappear. This script is run after the scripts in /etc/kernel/prerm.d directory.
    Package creator | Status
    Debian linux source package | unsupported since v4.6.1-1;
     | previously supported
    Ubuntu linux source package | unsupported since v4.15.0-18.19;
     | previously supported
    kernel-package | deprecated

src_postinst_hook
    MISSBILLIGT: Anders als die anderen Hook-Variablen ist dies für ein Skript gedacht, das während der Vorinstallation (»post inst«) eines Dokumentations-, Header- oder Quellpakets ausgeführt wird. Die Verwendung dieses Hooks ist nun missbilligt, das Vorinstallationsskript für das Headers-Skript soll nur den »header_postinst_hook« ausführen. Der Pfad kann relativ sein, falls das Skript in einem sicheren Pfad liegt – dies sind /bin, /sbin, /usr/bin oder /usr/sbin oder es muss stattdessen ein absoluter Pfad sein. Die Umgebungsvariable KERNEL_PACKAGE_VERSION soll auf die Version von kernel-package gesetzt werden, das dieses Paket erstellte. Dieses Skript soll mit zwei Argumenten aufgerufen werden. Das erste ist die Version des Kernel-Images und das zweite der Speicherplatz des Kernel-Images selbst. Fehler im Skript sollen das Fehlschlagen von »postinst« verursachen. Dieses Skript wird nach den Skripten im Verzeichnis /etc/kernel/postinst.d ausgeführt.
    Package creator | Status
    Debian linux source package | unsupported
    Ubuntu linux source package | unsupported
    kernel-package | deprecated

header_postinst_hook
    DEPRECATED: Unlike the other hook variables, this is meant for a script run during the post inst of a headers package only. The path can be a relative path if the script lives in a safe path -- that is, if it lives in /bin, /sbin, /usr/bin, or /usr/sbin, or must be an absolute path instead. In packages created by kernel-package, the environment variable KERNEL_PACKAGE_VERSION shall be set to the version of the kernel-package that created the package. This script shall be called with two arguments, the first being the name of the package being installed, and the second argument being the version of the package being installed. Errors in the script shall cause the postinst to fail. This script is run after the scripts in /etc/kernel/header_postinst.d directory.
    Package creator | Status
    Debian linux source package | unsupported
    Ubuntu linux source package | unsupported since v4.15.0-18.19;
     | previously supported
    kernel-package | deprecated

clobber_modules
    Falls gesetzt, soll »preinst« stillschweigend versuchen, /lib/modules/version aus dem Weg zu räumen, wenn die gleiche Version wie das Image installiert wird. Benutzung auf eigene Gefahr. Diese Variable ist standardmäßig nicht gesetzt.
    Package creator | Status
    Debian linux source package | ignored
    Ubuntu linux source package | ignored
    kernel-package | supported

warn_reboot
    Diese Variable kann benutzt werden, um die Warnung abzuschalten, wenn ein Kernel-Image installiert wird, das die gleiche Version hat wie das aktuell laufende. Falls die Liste der Module geändert wurde, könnten sich die Modulabhängigkeiten geändert haben und die Module für den neuen Kernel werden möglicherweise nicht korrekt auf dem laufenden Kernel ausgeführt, falls sich das ABI in der Zwischenzeit geändert hat. Es ist empfehlenswert, den Rechner neu zu starten und dieser Hinweis soll Sie daran erinnern. Falls Sie wissen, was Sie tun, können Sie diese Variable auf »no« setzen. Standardmäßig ist diese Variable gesetzt.
    Package creator | Status
    Debian linux source package | ignored
    Ubuntu linux source package | ignored
    kernel-package | supported

relink_build_link
    Diese Option manipuliert den von aktuellen Kerneln erstellten Bauverweis. Falls der Verweis defekt ist und die entsprechenden Kernel-Header auf dem System installiert zu sein scheinen, soll ein neuer symbolischer Verweis erstellt werden, der darauf zeigt. Vorgabe ist, den Bauverweis erneut zu verknüpfen (YES).
    Package creator | Status
    Debian linux source package | ignored
    Ubuntu linux source package | ignored
    kernel-package | supported

force_build_link
    Diese Option manipuliert den durch aktuelle Kernel erstellten Bauverweis. Falls der Verweis defekt ist, soll ein neuer symbolischer Verweis erstellt werden, der auf die Kernel-Header-Daten in /usr/src verweist, unabhängig davon, ob sie installiert sind oder nicht. Standardmäßig ist sie nicht gesetzt, damit keine potentiell defekten Verweise erstellt werden.
    Package creator | Status
    Debian linux source package | ignored
    Ubuntu linux source package | ignored
    kernel-package | supported

relink_src_link
    Diese Option manipuliert den durch aktuelle Kernel erstellten Quellverweis. Falls der Verweis defekt ist, wird er bei der Installation gelöscht. Vorgabe ist, den Quellverweis wieder zu verknüpfen (löschen) (YES).
    Package creator | Status
    Debian linux source package | ignored
    Ubuntu linux source package | ignored
    kernel-package | supported

silent_modules
    Diese Option wurde für die Leute eingebaut, die durch die Warnung über das vorher existierende Verzeichnis /lib/modules/$version erheblich irritiert wurden. Dieses Verzeichnis könnte zu einem alten oder nicht mehr existierenden Kernel-Image-Paket gehören. In diesem Fall können Probleme mit übriggebliebenen Modulen in diesem Verzeichnisbaum auftreten oder das Verzeichnis könnte aufgrund eines unabhängigen Modulpakets zu Recht existieren, das für diese Kernel-Version installiert wird und bereits entpackt wurde. In diesem letzeren Fall ist die Existenz des Verzeichnisses ungefährlich. Falls Sie diese Variable setzen, haben Sie nicht länger die Möglichkeit abzubrechen, falls ein vorher existierendes Modulverzeichnis /lib/modules/$version entdeckt wird. Dies ist standardmäßig nicht gesetzt.
    Package creator | Status
    Debian linux source package | ignored
    Ubuntu linux source package | ignored
    kernel-package | supported

ignore_depmod_err
    Falls gesetzt, wird nach einem Depmod-Problem im Vorinstallationsskript nicht gefragt, ob fortgesetzt werden soll. Dies erleichtert automatische Installationen, könnte allerdings ein Problem mit dem Kernel-Image verbergen. Eine Diagnose wird immer noch ausgegeben. Dies ist standardmäßig nicht gesetzt.
    Package creator | Status
    Debian linux source package | unsupported since v4.4.1-1~exp1;
     | previously supported
    Ubuntu linux source package | unsupported since v4.15.0-18.19;
     | previously ignored
    kernel-package | supported

DATEIEN
The file described here is /etc/kernel-img.conf. kernel-common includes example scripts suitable for dropping into /etc/kernel/*.d installed in /usr/share/doc/kernel-common/examples.

SIEHE AUCH
linux-update-symlinks(8), make-kpkg(1), kernel-pkg.conf(5)

AUTOR
Diese Handbuchseite wurde von Manoj Srivastava <srivasta@debian.org> und Ben Hutchings <benh@debian.org> für das Debian-GNU/Linux-System geschrieben.