KERNEL-IMG.CONF(5)

NOM
kernel-img.conf - configuration file for Linux kernel packages

SYNOPSIS
/etc/kernel-img.conf

DESCRIPTION
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

Le format de ce fichier consiste simplement en paires VARIABLE=VALEUR. Les valeurs booléennes peuvent être écrites Yes, True, 1, ou No, False, 0, sans distinction entre les majuscules et les minuscules. Ce fichier est automatiquement créé par le script d'installation dans certaines circonstances.

Les variables actuellement modifiables par l'utilisateur sont les suivantes :

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
    OBSOLETE : Contrairement aux autres variables de type « hook », cette variable indique un script qui sera exécuté pendant la phase de postinstallation d'un paquet de documentation, d'en-têtes ou de sources. L'utilisation de cette possibilité pour les paquets d'en-têtes est maintenant déconseillée ; le script de postinstallation des paquets d'en-têtes doit seulement lancer le script headers_postinst_hook. Le chemin peut être un chemin relatif si le script est situé dans un répertoire « sûr » (c'est-à-dire s'il est dans /bin, /sbin, /usr/bin, ou /usr/sbin), sinon il doit être exprimé en absolu. La variable d'environnement KERNEL_PACKAGE_VERSION doit contenir la version de kernel-package chargée de la création du paquet. Ce script doit être appelé avec deux arguments, le premier est le nomdu paquet à installer (ce peut être les sources noyau, ou les entêtes), et le second est la version du paquet à installer. Des erreurs dans le script déclencheront un échec de postinst. Ce script est exécuté après les scripts du répertoire /etc/kernel/src_postinst.d.
    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
    Quand cette variable est déclarée, le script de préinstallation cherchera à déplacer silencieusement /lib/modules/version, si cette version est la même que celle de l'image à installer. Utilisez-la à vos risques et périls. Cette variable n'a pas de valeur par défaut.
    Package creator | Status
    Debian linux source package | ignored
    Ubuntu linux source package | ignored
    kernel-package | supported

warn_reboot
    Cette variable peut être utilisée pour désactiver l'émission des alertes (« warnings ») lors de l'installation d'une image du noyau qui est de la même version que celle actuellement lancée. Si la liste des modules a changé, les dépendances entre modules ont peut-être été modifiées, et les modules du nouveau noyau pourraient ne pas fonctionner correctement avec le noyau actuel, notamment si la liste des ABI du noyau a changé entre les deux. C'est une bonne idée de redémarrer la machine, et un message vous le précisera. Si vous savez ce que vous faites, vous pouvez définir cette variable à « no ». Cette variable est active par défaut.
    Package creator | Status
    Debian linux source package | ignored
    Ubuntu linux source package | ignored
    kernel-package | supported

relink_build_link
    Cette option manipule le « build link » créé par les noyaux récents. Si le lien est un lien ballant et si les en-têtes du noyau correspondants semblent avoir été installés sur le système, un nouveau lien symbolique sera créé et pointera sur eux. La valeur par défaut est de relier le lien de construction (« YES »).
    Package creator | Status
    Debian linux source package | ignored
    Ubuntu linux source package | ignored
    kernel-package | supported

force_build_link
    Cette option manipule le lien de construction « build link » créé par les noyaux récents. Si le lien est un lien ballant, un nouveau lien symbolique sera créé et pointera sur /usr/src/, que ces en-têtes aient été installées ou non. Il n'y a pas de valeur par défaut, les liens symboliques potentiellement ballants ne sont pas créés par défaut.
    Package creator | Status
    Debian linux source package | ignored
    Ubuntu linux source package | ignored
    kernel-package | supported

relink_src_link
    Cette option manipule le « source link » créé par les noyaux récents. Si le lien est un lien ballant, il sera effacé au moment de l'installation. La valeur par défaut est de relier (effacer) le lien des sources (« YES »).
    Package creator | Status
    Debian linux source package | ignored
    Ubuntu linux source package | ignored
    kernel-package | supported

silent_modules
    Cette option est là pour ceux qui sont excédés par les avertissements concernant l'existence d'un répertoire de modules /lib/modules/$version. Ce répertoire peut appartenir à un ancien paquet image du noyau, qui a peut-être même disparu, auquel cas les modules restant dans ce répertoire peuvent poser problème ; ou bien, ce répertoire a le droit d'exister parce qu'on installe un paquet indépendant des modules d'une version du noyau qui a déjà été dépaquetée. Dans ce dernier cas, l'existence de ce répertoire est bénigne. Si vous utilisez cette variable, vous n'aurez plus la possibilité d'interrompre l'installation si un répertoire /lib/modules/$version est détecté. Cette variable n'a pas de valeur par défaut.
    Package creator | Status
    Debian linux source package | ignored
    Ubuntu linux source package | ignored
    kernel-package | supported

ignore_depmod_err
    If set, does not prompt to continue after a depmod problem in the postinst script. This facilitates automated installs, though it may mask a problem with the kernel image. A diagnostic is still issued. This is unset by default.
    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

FICHIERS
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.

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

AUTEUR
This manual page was written by Manoj Srivastava <srivasta@debian.org> and Ben Hutchings <benh@debian.org> for the Debian GNU/Linux system.