Linux Certif

Toute la documentation sur la certification Linux LPI

kernel-pkg.conf

NOM

kernel-pkg.conf - configuration file for make-kpkg

SYNOPSIS

/etc/kernel-pkg.conf ou ~/.kernel-pkg.conf

DESCRIPTION

The file /etc/kernel-pkg.conf or ~/.kernel-pkg.conf is actually a Makefile snippet included during the kernel packages build process, and hence you may put any legal Makefile directive in that file (just make very sure you know what you are doing). If the per user configuration file ~/.kernel-pkg.conf exists, it is loaded in favor of the system wide configuration file /etc/kernel-pkg.conf.

Toutes les variables ont des valeurs raisonnables par défaut, et peuvent être outrepassées ponctuellement ou sur la base de choix de l'utilisateur grâce aux variables d'environnement. Certaines de ces variables peuvent de plus être modifiées grâce à des options de make-kpkg.

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

maintainer

Local kernel (image, header, doc, etc) package maintainer. Set up at package installation by the postinst. Can be overridden by the environment variable KPKG_MAINTAINER. Please note that any apostrophes "'" shall have to be quoted like so: maintainer = John O'\''Brien. Yes, this is ugly, but this works.

email

L'adresse de courriel de cette personne. Définie lors de l'installation du paquet par le script de post-installation. Il est possible de l'outrepasser grâce à la variable d'environnement KPKG_EMAIL.

pgp

A key-ID to use when signing packages. Usually passed along to dpkg-buildpackage using the -k option, and also third party modules in the KMAINT environment variable, if separate modules (like pcmcia etc) are being built in $MODULE_PATH. Can be overridden by the environment variable PGP_SIGNATURE, and is overridden (again) by the --pgpsign option of make-kpkg. Defaults to maintainer. (Optional)

debian

The version of the kernel packages, includes both the upstream version and the Debian revision. Can be overridden by the environment variable DEBIAN_REVISION, and is overridden (again) by the --revision option of make-kpkg. Defaults to <VERSION>-10.0.0.Custom (Optional)

debian_revision_mandatory

Habituellement non définie. Si elle, ou la variable d'environnement DEBIAN_REVISION_MANDATORY, sont définies, alors l'absence de numéro de révision Debian entraînera une erreur (et make-kpkg ne fournira pas la valeur par défaut « 10.0.0.Custom »).

kimage

Type d'image du noyau (zImage ou bzImage par exemple). Il est possible de l'outrepasser grâce à la variable d'environnement IMAGE_TYPE, et il est possible de l'outrepasser (de nouveau) grâce aux options --zimage ou --bzimage de make-kpkg. Valeur par défaut : bzImage. (Optionnel)

config_target

What type of configure step to do. Defaults to oldconfig, which is good for non-interactive (or minimally interactive) runs. (ENV variable CONFIG_TARGET overrides this setting.) If the value of config_target is not recognized, then it is reset to oldconfig.

use_saved_config

Variable réservée seulement aux experts. Si elle est réglée à « NO » (la variable d'environnement USE_SAVED_CONFIG outrepasse cela), le fichier .config.save du répertoire au sommet de l'arborescence est ignoré.

root_cmd

C'est une variable dont le but est d'être transmise à dpkg-buildpackage dans la cible buildpackage. Elle doit fournir un moyen d'obtenir les droits d'accès du superutilisateur ( « sudo » ou « fakeroot » par exemple), un peu à la façon de l'option -r de dpkg-buildpackage. La variable d'environnement ROOT_CMD a priorité sur celle-ci. La variable d'environnement UNSIGN_SOURCE fournit à cette commande l'option qui force dpkg-buildpackage à ne pas signer la source, et de la même façon, la variable d'environnement UNSIGN_CHANGELOG fournit à cette commande l'option qui force dpkg-buildpackage à ne pas signer le changelog. Là encore, cette variable n'est utile que pour la cible buildpackage. Réglez la variable d'environnement ROOT_CMD si vous voulez juste construire l'image du noyau, par exemple.

delete_build_link

Lorsque réglée à « YES », supprime le lien symbolique /lib/modules/$VERSION/build pointant sur le paquet .deb. La variable d'environnement DELETE_BUILD_LINK a priorité sur cette option.

do_clean        

Si elle est définie à « YES », un make clean sera lancé sur l'arborescence
des sources du noyau après la construction du paquet de l'image du noyau. La variable d'environnement CLEAN_SOURCE a priorité sur cette option.

install_vmlinux

Set to YES to install the uncompressed kernel ELF image along with the bootable compressed kernel image (vmlinuz).

image_clean_hook

Lorsqu'elle correspond à un programme, celui-ci est alors exécuté sur la racine (temporaire) de l'arborescence du noyau avant l'empaquetage des sources. Cela n'a aucun effet sur quoi que ce soit d'autre que les sources en cours d'empaquetage. Si le script agit sur le répertoire courant et ses fils, l'arborescence originale des sources demeure inchangée. Utile pour faciliter le modelage des sources du noyau en cours d'empaquetage.

source_clean_hook

Lorsqu'il correspond à un programme, celui-ci est alors lancé sur la racine des répertoires des en-têtes du noyau avant leur empaquetage, ./debian/tmp-source/usr/src/kernel-source-X.X.XX. Cela n'a aucun effet sur quoi que ce soit d'autre que les sources en cours d'empaquetage. Si le script agit sur le répertoire courant et ses fils, l'arborescence originale des sources demeure inchangée. Utile pour faciliter le modelage des en-têtes du noyau en cours d'empaquetage (en supprimant par exemple les répertoires de contrôle de version, ou en se débarrassant des architectures non désirées).

header_clean_hook

Lorsqu'il correspond à un programme, celui-ci est alors lancé sur la racine des répertoires des en-têtes du noyau avant leur empaquetage. Cela n'a aucun effet sur quoi que ce soit d'autre que les sources en cours d'empaquetage. Si le script agit sur le répertoire courant et ses fils, l'arborescence originale des sources demeure inchangée. Utile pour faciliter la cure d'amaigrissement des en-têtes du noyau en cours d'empaquetage (en supprimant par exemple les répertoires de contrôle de version, ou en se débarrassant des architectures non désirées).

doc_clean_hook

Lorsqu'il correspond à un programme, celui-ci est alors exécuté sur la racine de l'arborescence de la documentation avant son empaquetage. Cela n'a aucun effet sur quoi que soit d'autre que la documentation en cours d'empaquetage. Si le script agit sur le répertoire courant et ses fils, l'arborescence originale demeure inchangée. Utile pour faciliter le modelage de la documentation du noyau en cours d'empaquetage (en supprimant par exemple les répertoires de contrôle de version, ou en se débarrassant des architectures non désirées).

extra_docs

Cette variable pourra contenir le chemin vers toute documentation supplémentaire qui sera alors installée dans le répertoire /usr/share/doc/kernel-image-X.X.XX/. Il n'y a pas de détection de conflit de noms, et les fichiers ne sont pas compressés. De ce fait, si vous voulez que ces fichiers soient compressés, compressez-les et indiquez alors le chemin vers le fichier compressé. La variable d'environnement EXTRA_DOCS a priorité sur cette option, et indiquera certainement la manière de spécifier la documentation supplémentaire.

kpkg_follow_symlinks_in_src

This option is especially useful for people who use symlink farms to compile kernels. With this option, kernel-source and kernel-header packages shall not be just full of dangling symlinks, instead, the symbolic links shall be followed. Please note that any symbolic links in the kernel sources would be flattened as well. The environment variable KPKG_FOLLOW_SYMLINKS_IN_SRC overrides this.

make_libc_headers

Variable pour le responsable de la libc6 qui, lorsqu'il compile la libc6, empaquette aussi les en-têtes correspondants. N'Y TOUCHEZ PAS à moins de savoir ce que vous faites, car une différence entre les en-têtes que vous empaquetez et la libc6 peut vraiment déclencher de subtiles instabilités dans tous les codes compilés sur votre machine. Vous êtes prévenu. La variable d'environnement MAKE_LIBC_HEADERS a priorité sur cette option.

CONCURRENCY_LEVEL

Si elle est définie, cette variable règle le nombre de processus concurrents qu'utilisera make pour compiler le noyau et les modules, grâce à l'option -j de la commande make lancée par la cible build de make-kpkg. Doit être, si elle est définie, un (petit) entier.

ARCH_IN_NAME

Si elle est définie, cette variable force make-kpkg à utiliser un nom rallongé pour le paquet de l'image du noyau, en intégrant la sous-architecture dans le nom de l'image ; ainsi, on peut écrire des scripts pour créer de multiples sous-architectures, l'une après l'autre. Notez bien que seul le nom du paquet est changé, pas l'emplacement des modules, etc.

CONFDIR

Cette variable pourra pointer sur un répertoire contenant les fichiers .config spécifiques aux différentes architectures (consultez /usr/share/kernel-package/Config pour voir des exemples). Pratique pour compiler pour plusieurs architectures. Pointe par défaut sur /usr/share/kernel-package/Config.

IMAGEDIR

Si vous voulez que l'image soit stockée ailleurs que dans /boot, définissez le répertoire de destination dans cette variable. Cela pourra être utile aux utilisateurs de loadlin. Pointe par défaut sur /boot.

MODULE_LOC

Réglez cette variable, soit dans votre environnement, soit dans le fichier de configuration, afin qu'elle pointe sur l'endroit où sont situés les modules additionnels. Pointe par défaut sur /usr/src/modules.

CONFDIR

Réglez cette variable, soit dans votre environnement, soit dans le fichier de configuration, afin qu'elle pointe sur l'endroit où sont situés les fichiers de configuration du noyau. Pointe par défaut sur /usr/share/kernel-package/Config.

Le contenu d'une variable est définie de la façon suivante :

a)

Les valeurs par défaut sont présentes dans le fichier « rules ». Ces valeurs sont utilisées si aucun réglage n'est fait.

b)

Les variables peuvent être réglées dans le fichier de configuration /etc/kernel-pkg.conf. Ces valeurs ont priorité sur les valeurs par défaut.

c)

Les variables peuvent aussi être définies en donnant une valeur à la variable d'environnement correspondante. Ces valeurs ont priorité sur le fichier de configuration et sur les valeurs par défaut.

d)

Par l'utilisation des options de make-kpkg, ou, lorsqu'on utilise directement les fichiers « rules », sur la ligne de commande.
# xxx/rules DEBIAN_REVISION=2.0a kernel_image
Cette commande a priorité sur toutes les méthodes décrites ci-dessus.

FICHIERS

Le fichier ici décrit est /etc/kernel-pkg.conf ou ~/.kernel-pkg.conf.

VOIR AUSSI

make-kpkg(1), kernel-img.conf(5), make(1), le manuel GNU Make

BOGUES

Il n'y a pas d'erreur. Toute ressemblance avec un bogue est du délire. Vraiment.

AUTEUR

Cette page a été écrite par Manoj Srivastava, <srivasta@debian.org>, pour le système Debian GNU/Linux.