KERNEL-IMG.CONF(5)

NOM
kernel-img.conf - Fichier de configuration pour les paquets du noyau Linux

SYNOPSIS
/etc/kernel-img.conf

DESCRIPTION
Le fichier /etc/kernel-img.conf est utilisé par le processus d'installation et de supression du paquet du noyau pour autoriser le traitement de quelques aspects de l'installation par des options locales. La plupart des variables de configuration ne s'appliquent qu'aux paquets de l'image du noyau.

Tous les créateurs de paquets d'images de noyau ne prennent pas en charge ce fichier, ni toutes les variables de configuration. Le statut de prise en charge pour le fichier est :
Package creator | Status
Paquet source linux Debian | pris en charge
paquet source linux Ubuntu | pris en charge
kernel-package | pris en charge
make deb-pkg | ignoré

Le format de ce fichier consiste simplement en paires VARIABLE=VALEUR. Les valeurs booléennes peuvent être fixées à 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
    Quand cette variable est déclarée, les scripts postinst et postrm maintiendront les liens symboliques vers les images du noyau et du disque mémoire initial par défaut, comme expliqué dans linux-update-symlinks(8). Cette variable est active par défaut.
    Package creator | Status
    Paquet source linux Debian | pris en charge
    paquet source linux Ubuntu | pris en charge
    kernel-package | ignoré depuis la version v12.001
     | anciennement pris en charge

image_dest
    Indiquer dans cette variable le dossier dans lequel les liens symboliques vers les images du noyau et du disque mémoire initial par défaut devraient être maintenus. La valeur par défaut est /.
    Package creator | Status
    Paquet source linux Debian | pris en charge
    paquet source linux Ubuntu | pris en charge
    kernel-package | ignoré depuis la version v12.001
     | anciennement pris en charge

link_in_boot
    Quand cette variable est déclarée, cela a le même effet que image_dest= /boot et écrase tout autre réglage de image_dest. Cette variable n'a pas de valeur par défaut.
    Package creator | Status
    Paquet source linux Debian | pris en charge
    paquet source linux Ubuntu | pris en charge
    kernel-package | ignoré depuis la version v12.001
     | anciennement pris en charge

postinst_hook
    OBSOLETE : Indiquez cette variable à un script à exécuter durant l'installation. Le chemin peut être un chemin relatif si le script est situé dans un chemin sûr (c'est à dire s'il se trouve dans /bin, /sbin, /usr/bin, ou /usr/sbin), sinon il doit être dans un chemin absolu. Avant d'appeler ce script, la variable d'environnement STEM doit être définie avec la même valeur que l'argument --stem (ou contenir la valeur par défaut, linux), et dans les paquets créés par kernel-package KERNEL_PACKAGE_VERSION doit être défini à la version de kernel-package qui a créé le paquet. Ce script doit être appelé avec deux arguments, le premier étant la version de l'image du noyau et le second étant l'emplacement de l'image du noyau.Des erreurs dans le script causeront l'échec de la post-installation. Lorsqu'on utilise debconf avant l'appel du script, ce dernier ne générera pas de message de diagnostic sur la sortie standard. En effet, au moment où la postinstallation apelle db_stop, debconf ne rétablit pas la sortie standard, donc tous les messages en sa direction disparaissent. Un exemple de script pour les utilisateurs de grub est présent dans le répertoire /usr/share/doc/kernel-package/ . Ce script est lancé après les scripts dans le répertoire /etc/kernel/postinst.d.
    Package creator | Status
    Paquet source linux Debian | non pris en charge depuis la version v4.6.1-1 ;
     | anciennement pris en charge
    paquet source linux Ubuntu | non pris en charge depuis la version v4.15.0-18.19 ;
     | anciennement pris en charge
    kernel-package | obsolète

postrm_hook
    OBSOLETE : Indiquez cette variable à un script à exécuter dans le postrm (c'est-à-dire, après que l'image a été supprimée) après que toutes les actions de suppression ont été effectuées. 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 /usn/sbin), sinon il doit être exprimé en absolu. Dans les paquets créés par kernel-package la variable d'environnement KERNEL_PACKAGE_VERSION doit contenir la version de kernel-package qui a créé le paquet. Ce script doit être appelé avec deux arguments, le premier est la version de l'image du noyau, et le second est l'adresse de l'image du noyau elle-même. Des erreurs dans le script déclencheront un message d'avertissement, mais sera ignoré. Lorsqu'on utilise debconf avant l'appel du script, ce dernier ne générera pas de message de diagnostic sur la sortie standard. En effet, au moment où la postinstallation appelle db_stop, debconf ne rétablit pas la sortie standard, donc tous les messages en sa direction disparaissent. Ce script est exécuté après les scripts du répertoire /etc/kernel/postrm.d.
    Package creator | Status
    Paquet source linux Debian | non pris en charge depuis la version v4.6.1-1 ;
     | anciennement pris en charge
    paquet source linux Ubuntu | non pris en charge depuis la version v4.15.0-18.19 ;
     | anciennement pris en charge
    kernel-package | obsolète

preinst_hook
    OBSOLETE : Indiquez cette variable à un script à exécuter avant que le paquet ne soit dépaqueté ; il peut servir à effectuer d'autres contrôles. 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. Dans les paquets créés par kernel-package la variable d'environnement KERNEL_PACKAGE_VERSION doit être définie à la version de kernel-package qui a créé le paquet. Ce script doit être appelé avec deux arguments, le premier est la version de l'image du noyau, et le second est l'adresse de l'image du noyau elle-même. Ce script est exécuté après les scripts du répertoire /etc/kernel/preinst.d.
    Package creator | Status
    Paquet source linux Debian | non pris en charge depuis la version v4.6.1-1 ;
     | anciennement pris en charge
    paquet source linux Ubuntu | non pris en charge depuis la version v4.15.0-18.19 ;
     | anciennement pris en charge
    kernel-package | obsolète

prerm_hook
    OBSOLETE : Indiquez cette variable à un script à exécuter avant que les fichiers du paquet ne soient supprimés (donc tout fichier ajouté peut être supprimé). 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. Dans les paquets créés par kernel-package la variable d'environnement KERNEL_PACKAGE_VERSION doit être définie à la version de kernel-package qui a créé du paquet. Ce script doit être appelé avec deux arguments, le premier est la version de l'image du noyau, et le second est l'adresse de l'image du noyau elle-même. Des erreurs dans le script déclencheront un échec de prerm. Lorsqu'on utilise debconf avant que le script ne soit appellé, ce dernier ne générera pas de message de diagnostic sur la sortie standard. En effet, au moment où la postinstallation appelle db_stop debconf ne rétablit pas la sortie standard, donc tous les messages en sa direction disparaissent. Ce script est exécuté après les scripts du répertoire /etc/kernel/prerm.d.
    Package creator | Status
    Paquet source linux Debian | non pris en charge depuis la version v4.6.1-1 ;
     | anciennement pris en charge
    paquet source linux Ubuntu | non pris en charge depuis la version v4.15.0-18.19 ;
     | anciennement pris en charge
    kernel-package | obsolète

src_postinst_hook
    OBSOLETE : Contrairement aux autres variables de type « hook », cette variable est destinée à 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 qui a créé le paquet. Ce script doit être appelé avec deux arguments, le premier est le nom du 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
    Paquet source linux Debian | non pris en charge
    paquet source linux Ubuntu | non pris en charge
    kernel-package | obsolète

header_postinst_hook
    OBSOLETE : Contrairement aux autres variables de type « hook », cette variable est destinée à un script qui sera exécuté pendant la phase de postinstallation d'un paquet d'en-têtes seulement. 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. Dans les paquets créés par kernel-package la variable d'environnement KERNEL_PACKAGE_VERSION doit être définie à la version de kernel-package qui a créé le paquet. Ce script sera appelé avec deux arguments, le premier étant le nom du paquet à installer, le second étant la version du paquet à être installé. Des erreurs dans le script déclencheront un échec de la postinstallation. Ce script est exécuté après les scripts du répertoire /etc/kernel/src_postinst.d.
    Package creator | Status
    Paquet source linux Debian | non pris en charge
    paquet source linux Ubuntu | non pris en charge depuis la version v4.15.0-18.19 ;
     | anciennement pris en charge
    kernel-package | obsolète

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
    Paquet source linux Debian | ignoré
    paquet source linux Ubuntu | ignoré
    kernel-package | pris en charge

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
    Paquet source linux Debian | ignoré
    paquet source linux Ubuntu | ignoré
    kernel-package | pris en charge

relink_build_link
    Cette option manipule le lien de construction (« 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 recréer le lien de construction (« YES »).
    Package creator | Status
    Paquet source linux Debian | ignoré
    paquet source linux Ubuntu | ignoré
    kernel-package | pris en charge

force_build_link
    Cette option manipule le lien de construction 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és ou non. Il n'y a pas de valeur par défaut, les liens symboliques potentiellement pendants ne sont pas créés par défaut.
    Package creator | Status
    Paquet source linux Debian | ignoré
    paquet source linux Ubuntu | ignoré
    kernel-package | pris en charge

relink_src_link
    Cette option manipule le « source link » créé par les noyaux récents. Si le lien est un lien pendant, il sera effacé au moment de l'installation. La valeur par défaut est de recréer (effacer) le lien des sources (« YES »).
    Package creator | Status
    Paquet source linux Debian | ignoré
    paquet source linux Ubuntu | ignoré
    kernel-package | pris en charge

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
    Paquet source linux Debian | ignoré
    paquet source linux Ubuntu | ignoré
    kernel-package | pris en charge

ignore_depmod_err
    Quand cette variable est déclarée, ne demande pas de continuer après un problème depmod dans le script postinst. Cela facilite les installations automatisées, bien que cela pourrait masquer un problème avec l'image du noyau. Un diagnostic est encore émis. Cela n'est pas activé par défaut.
    Package creator | Status
    Paquet source linux Debian | non pris en charge depuis la version v4.4.1-1~exp1 ;
     | anciennement pris en charge
    paquet source linux Ubuntu | non pris en charge depuis la version v4.15.0-18.19 ;
     | anciennement ignoré
    kernel-package | pris en charge

FICHIERS
Le fichier décrit ici est /etc/kernel-img.conf. kernel-common contient des scripts d’exemple pouvant être placés dans /etc/kernel/*.d, installés dans /usr/share/doc/kernel-common/examples.

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

AUTEUR
Cette page de manuel a été écrite par Manoj Srivastava <srivasta@debian.org> et Ben Hutchings <benh@debian.org> pour le système Debian GNU/Linux.