table of contents
KERNEL-IMG.CONF(5) | Debian-GNU/Linux-Handbuch | 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.
24. März 2019 | Debian |