✎ tutoriel:comment_compiler_un_kernel_sur_mesure [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

----

====== Comment compiler un noyau sur mesure ? ======
**ou //Comment personnaliser son noyau ?//** (On entend aussi souvent le mot « kernel », qui signifie « noyau » en français, de l'allemand « kern »)

===== Versions concernées =====

* Dapper, Edgy, Gutsy
  * :!: pour Feisty, utilisez la méthode alternative :!:

=====Introduction=====

Dans la suite de ce didacticiel, le mot kernel est utilisé car beaucoup d'entre l'ont entendu, ou l'entendront sûrement au milieu d'une conversation en français.

====Avertissement====

Compiler et utiliser un kernel personnalisé va rendre compliqué le support pour votre système. Vous ne serez pas autorisé à rapporter des bogues pour votre kernel personnalisé (ils seront rejetés sans explication).

Si vous avez un contrat de support commercial avec Ubuntu/Canonical, ceci rendra ce support caduque.

Notez par ailleurs que cette page décrit comment procéder pour le kernel d'Edgy (2.6.17) ou ultérieur ! Les versions précédentes ne comprenaient pas, intentionnellement, un tel mécanisme permettant de compiler aisément son propre noyau.

Cette page **ne** décrit **pas** comment compiler les kernels provenant de kernel.org. Elle est destinée aux sources du kernel Ubuntu.

====Bonnes raisons de compiler un kernel personnalisé====

* Vous êtes un développeur du kernel.
   * Vous avez besoin de compiler d'une façon spéciale, que le kernel officiel n'offre pas (par exemple, pour activer des fonctionnalités expérimentales).
   * Vous essayez de déboguer un problème (pour lequel il serait peut-être judicieux de  remplir un rapport de bug à propos du kernel officiel Ubuntu).

====Mauvaises raisons de compiler un kernel personnalisé====

* Vous avez à tout prix besoin de compiler un pilote spécial. Pour cela, il vous faut seulement installer les paquets linux-headers.
   * Vous n'avez pas la moindre idée de ce que vous faites et, si vous cassez quelque chose, vous aurez besoin d'aide pour réparer. Si vous  détruisez votre système, réinstallez-le. Ne demandez de l'aide que si vous ne pouvez plus faire autrement.
   * Vous avez atterri sur cette page par erreur, mais vous la lisez car elle semble intéressante. Cela peut être intéressant, mais si vous ne savez pas ce que signifie le mot « processeur », alors laissez tomber de suite.

=====Prérequis====

Pour commencer, il faut [[:tutoriel:comment_installer_un_paquet|installer les paquets]] **linux-kernel-devel fakeroot kernel-wedge kernel-package**

Cela va installer les outils relatifs à la compilation et l'empaquetage du kernel. Le paquet **git-core**, qui est le meilleur moyen pour interagir avec les sources du kernel Ubuntu, sera aussi installé.

Note: Le paquet linux-kernel-devel n'existe pas dans intrepid. Pour compiler le kernel avec intrepid, vous devez aussi lancer la commande suivante :
<code>
sudo apt-get build-dep linux
</code>

=====Téléchargement des sources=====

Il y a deux moyens pour obtenir les sources du kernel Ubuntu. Idéalement, il faudrait utiliser **git**. Les instructions détaillées pour l'utiliser sont disponibles sur [[:git-core]].

La seconde méthode est plus simple : [[:tutoriel:comment_installer_un_paquet|installer le paquet]] **linux-source**

Cependant, ce ne sera pas toujours à jour. L'utilisation de **git** vous permet de toujours rester à jour avec la dernière version des sources du kernel Ubuntu.

Il faut maintenant décompacter le fichier que vous venez de télécharger
<code>
cd /usr/src

sudo tar --bzip2 -xvf linux-source
</code>

=====Adaptation des sources à vos besoins=====

Pour la majorité des gens, modifier seulement les fichiers de configuration suffira. Si vous devez appliquer un patch, lisez les instructions données par le fournisseur du patch.

Les configurations "officielles" Ubuntu se trouvent dans //debian/config/ARCH///, où //ARCH// désigne l'architecture pour laquelle vous compilez. Plusieurs fichiers sont présents dans ce répertoire. Le fichier //config// est la base pour toutes les cibles de cette architecture. Ensuite, les nombreux fichiers //config.FLAVOUR// contiennent des options spécifiques à chaque cible. Par exemple, voici les fichiers pour le kernel 2.6.17, et l'architecture i386 :
<code>
$ ls -l debian/config/i386/
total 88
-rw-r--r-- 1 me me 62737 Jun 14 18:31 config
-rw-r--r-- 1 me me 1859 Jun 12 14:59 config.386
-rw-r--r-- 1 me me 1394 Jun 12 14:59 config.686
-rw-r--r-- 1 me me 1420 Jun 12 14:59 config.k7
-rw-r--r-- 1 me me 1519 Jun 12 14:59 config.server
-rw-r--r-- 1 me me 1867 Jun 12 14:59 config.server-bigiron
</code>
Si vous devez changer une option de configuration, modifier simplement le fichier contenant l'option. Si vous éditez le fichier //config//, les changements affecteront toutes les architectures. Si vous modifiez un des fichiers cible, seule la cible sera affectée.

**Note** :  Si aucun fichier n'est présent, vous pouvez en trouver dans le répertoire ///boot//. Par exemple :
<code>
$ ls -l /boot | grep config
-rw-r--r-- 1 root root   69733 2006-08-03 05:10 config-2.6.15-26-686
-rw-r--r-- 1 root root   69759 2006-08-03 05:36 config-2.6.15-26-k7
</code>

Suite à l'application d'un patch ou l'ajout d'une option, il est préférable de régénérer les fichiers de configuration. Il y a un "assistant" pour cela. Pour régénérer toutes les architectures, exécutez :
<code>
debian/rules updateconfigs
</code>

Si vous voulez mettre à jour une architecture seulement, exécutez :
<code>
debian/bin/oldconfig ARCH
</code>

=====Compilation du kernel=====

La compilation du noyau est une étape très simple. Selon vos besoins, vous pouvez vouloir compiler toutes les cibles, ou seulement celle spécifique à votre système. Cependant, vous désirez aussi vous assurer que ce que vous faites n'entre pas en conflit avec le kernel officiel.

Utilisez la commande suivante pour construire toutes les cibles de l'architecture pour laquelle vous compilez :
<code>
AUTOBUILD=1 fakeroot debian/rules binary-debs
</code>

La variable d'environnement //AUTOBUILD// déclenche des fonctionnalités spéciales pendant la compilation du kernel. Premièrement, cela n'effectue pas les vérifications normales d'ABI (l'ABI est la compatibilité binaire). Cela est rendu possible par le fait qu'un unique identifiant d'ABI (ABI ID) est créé. Si vous utilisez le depôt **git**, cet identifiant est généré depuis le //git HEAD SHA//. Sinon, il est généré à l'aide du programme //uuidgen// (ce qui signifie qu'à chaque exécution de la construction avec //debian/rules//, l'identifiant sera différent !). Le paquet créé sera nommé à l'aide de cet identifiant.

Pour construire une cible spécifique, utilisez la commande suivante :
<code>
AUTOBUILD=1 fakeroot debian/rules binary-debs flavours=k7
</code>
Ceci aura pour effet de ne compiler que la variante AMD k7 de l'architecture i386.

Sur certaine installation, le message suivant peut survenir :
<code>
debian/rules:1637: *** Error. I do not know where the kernel image goes to [kimagedest undefined] The usual case for this is that I could not determine which arch or subarch tihs machine belongs to. Please specify a subarch, and try again.. Arrêt.
</code>
Dans ce cas, utilisez la commande suivante :
<code>
KPKG_ARCH=i386 AUTOBUILD=1 fakeroot debian/rules binary-debs flavours=k7
</code>
avec i386 ou tout autre architecture.
=====Installation=====

Les paquets ainsi générés sont placés dans //ubuntu-2.6/debian/build//.
Maintenant que la construction a réussi, vous pouvez installer les paquets à l'aide de dpkg :
<code>
sudo dpkg -i linux-image-2.6.17-2-ef427c-k7_2.6.17-2.2_i386.deb
sudo dpkg -i linux-headers-2.6.17-2-ef427c-k7_2.6.17-2.2_i386.deb
</code>

**Note** : Si vous utilisez les modules du paquets //linux-restricted-modules//, il sera nécessaire de les recompiler en utilisant votre nouveau paquet //linux-headers//. Des détails sur cette manipulations seront ajoutés ultérieurement

----
// Contributeurs : [[utilisateurs:mr_pouit]]//

// Basé sur [[https://wiki.ubuntu.com/KernelCustomBuild]]//

===== Méthode alternative =====

>FIXME : à déplacer sur une autre page non ?

Cette méthode a été testée avec succès sur une Ubuntu 7.04 (Feisty Fawn)

==== Pré-requis ====

Afin de permettre la compilation du noyau, il vous faut certains paquets,
ouvrez un terminal et tapez :

<code>sudo apt-get install build-essential bin86 kernel-package libqt3-headers libqt3-mt-dev bzip2</code>
__**ou**__
<code>sudo aptitude install build-essential bin86 kernel-package libqt3-headers libqt3-mt-dev bzip2</code>

==== Téléchargement et préparation du noyau ====

Nous allons maintenant télécharger le nouveau noyau dans le dossier /usr/src/ et le décompresser et continuer le travail dans /usr/src/linux
dans le terminal, tapez ceci :

<code>cd /usr/src && sudo wget http://www.kernel.org/pub/linux/kernel/v2.6/linux-2.6.27.tar.bz2 && sudo tar -xvjf linux-2.6.27.tar.bz2 && sudo rm -rf /usr/src/linux && sudo ln -s /usr/src/linux-2.6.27 /usr/src/linux && cd /usr/src/linux</code>

(au besoin, adaptez la 2.6.27 pour avoir la version du noyau désirée)
(attention, cette manipulation a été testée avec le noyau 2.6.27 donc, si vous modifiez la version du noyau, ce manuel peut être dangereux pour votre système)

Nous allons ensuite continuer en appliquant les derniers patchs sur le noyau :

<code>sudo wget http://www.kernel.org/pub/linux/kernel/v2.6/patch-2.6.27.bz2 && sudo -s -H && bzcat patch-2.6.27.bz2| patch -p1</code>
(à l'heure où j'écris ce manuel, la dernière version du patch est la 12, pour vérifier que c'est toujours votre cas, rendez-vous sur [[http://www.kernel.org/pub/linux/kernel/v2.6/]] et cherchez patch-2.6.20.X si X est plus grand que 12 alors, changez-les 12 dans la commande ci-dessus par la nouvelle valeur)

==== Importation des paramètres du noyau actuel et configuration ====

Nous allons maintenant procéder à la partie intéressante du sujet :
la configuration du noyau

La commande suivante aura pour effet de copier vos paramètres actuels dans le nouveau noyau et de lancer l'utilitaire de configuration qui vous permettra de personnaliser votre kernel :

<code>sudo cp /boot/config-`uname -r` .config && sudo make oldconfig && sudo make xconfig</code>
(NB : le terminal va vous demander des choses, appuyez juste sur "entrée" a moins de savoir exactement ce que vous faites)

Après un petit moment, vous allez voir la fenêtre de configuration apparaître à l'écran. Je vous laisse le choix des choses que vous voulez dans votre noyau mais je vous conseille juste dans "kernel hacking" de désactiver l'option "kernel debugging" (sinon la compilation va prendre un espace disque monstrueux !)

Une fois que vous avez choisi vos options, n'oubliez pas de les sauvegarder ;) (la petite disquette en haut à gauche :D), ensuite, fermez la fenêtre de configuration.

Si vous utilisez la version serveur, c'est-à-dire sans interface graphique, il vaut mieux utiliser menuconfig (qui est l'équivalent de xconfig mais en mode console) que xconfig (qui cherche à se connecter à un serveur X). Pour utiliser menuconfig, il faut installer la librairie de développement ncurses. Ce qui donne :
<code> sudo aptitude install libncurses5-dev</code>

Puis :

<code>sudo cp /boot/config-`uname -r` .config && sudo make oldconfig && sudo make menuconfig</code>

==== Compilation ====

Pour cette partie-ci, j'espère que vous n'êtes pas pressés car une compilation de noyau prend quand même du temps (de 1-3 heures en fonction de votre machine)

Pour lancer la compilation, dans le terminal, il vous suffit d'avoir la permission root et de taper :

<code>sudo make-kpkg clean && sudo make-kpkg --initrd --revision=386monNoyau kernel_image kernel_headers modules_image</code>
(NB : vous pouvez remplacer revision=386monNoyau par ce que vous voulez, ça ne change rien)

Et voila, vous devriez en avoir pour un bon bout de temps, c'est le moment d'aller promener le chien.

==== Installation du nouveau noyau ====

Voilà, la compilation est terminée, il vous reste juste à installer le nouveau noyau toujours dans le même terminal :

<code>cd .. && dpkg -i linux*.deb</code>

Ensuite, vous redémarrez l'ordinateur ;)

Ce document est une traduction d'un article créé par master_kernel, vous pouvez consulter le document original à cette adresse : [[http://ubuntuforums.org/showthread.php?t=311158&highlight=master+kernel]]
merci à lui pour cet excellent HowTo.

===== Liens =====

HOW-TO sympa : http://ubuntuforums.org/showthread.php?t=441013

How to Comment Compiler le dernier kernel pour Gusty via GIT:http://liaudetgael.free.fr/spip.php?article21

How to Comment changer l'image de chargement du Kernel:http://liaudetgael.free.fr/spip.php?article22

----

// Contributeurs : [[utilisateurs:Doyen]]//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : Q X A P D Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported