DOCUMENTATION :

• Il existe beaucoup de documentation disponible à la fois sous forme électronique sur Internet et dans des livres, à la fois spécifiques à Linux et concernant des questions UNIX générales. Je recommande de consulter les sous-répertoires de documentation sur tout site FTP Linux pour les livres du LDP (Linux Documentation Project). Ce README n'est pas destiné à être une documentation du système : il existe des sources bien meilleures.

• Il y a divers fichiers README dans le sous-répertoire Documentation/ : ils contiennent généralement des notes d'installation spécifiques au noyau pour certains pilotes par exemple. Voir Documentation/00-INDEX pour une liste de ce qui est contenu dans chaque fichier. Veuillez lire le fichier Changes, car il contient des informations sur les problèmes qui peuvent résulter de la mise à niveau de votre noyau.

• Le sous-répertoire Documentation/DocBook/ contient plusieurs guides pour les développeurs et utilisateurs du noyau. Ces guides peuvent être rendus dans un certain nombre de formats : PostScript (.ps), PDF, HTML, & pages de manuel, entre autres. Après l'installation, "make psdocs", "make pdfdocs", "make htmldocs", ou "make mandocs" produira la documentation dans le format demandé.

INSTALLATION des sources du noyau :

• Si vous installez les sources complètes, placez l'archive tar du noyau dans un répertoire où vous avez les droits (par ex. votre répertoire personnel) et décompressez-la :

  xz -cd linux-4.X.tar.xz | tar xvf -

  Remplacez "X" par le numéro de version du dernier noyau.

  N'utilisez PAS la zone /usr/src/linux ! Cette zone contient un ensemble (généralement incomplet) d'en-têtes du noyau utilisées par les fichiers d'en-tête de la bibliothèque. Ils doivent correspondre à la bibliothèque, et ne pas être perturbés par le noyau-du-jour.

• Vous pouvez aussi mettre à niveau entre les versions 4.x en appliquant des correctifs. Les correctifs sont distribués au format xz. Pour installer par correctif, obtenez tous les nouveaux fichiers de correctif, placez-vous dans le répertoire racine des sources du noyau (linux-4.X) et exécutez :

  xz -cd ../patch-4.x.xz | patch -p1

  Remplacez "x" par toutes les versions supérieures à la version "X" de votre arborescence source actuelle, dans_l'ordre, et tout devrait aller. Vous pouvez vouloir supprimer les fichiers de sauvegarde (some-file-name~ ou some-file-name.orig), et assurez-vous qu'il n'y a pas de correctifs échoués (some-file-name# ou some-file-name.rej). Si c'est le cas, soit vous, soit moi avons commis une erreur.

  Contrairement aux correctifs pour les noyaux 4.x, les correctifs pour les noyaux 4.x.y (également appelés noyaux -stable) ne sont pas incrémentaux mais s'appliquent directement au noyau de base 4.x. Par exemple, si votre noyau de base est 4.0 et que vous voulez appliquer le correctif 4.0.3, vous ne devez pas d'abord appliquer les correctifs 4.0.1 et 4.0.2. De même, si vous utilisez la version 4.0.2 du noyau et que vous voulez passer à la 4.0.3, vous devez d'abord inverser le correctif 4.0.2 (c'est-à-dire, patch -R) avant d'appliquer le correctif 4.0.3. Vous pouvez en lire plus à ce sujet dans Documentation/applying-patches.txt

  Alternativement, le script patch-kernel peut être utilisé pour automatiser ce processus. Il détermine la version actuelle du noyau et applique tous les correctifs trouvés.

  linux/scripts/patch-kernel linux

  Le premier argument dans la commande ci-dessus est l'emplacement des sources du noyau. Les correctifs sont appliqués depuis le répertoire courant, mais un répertoire alternatif peut être spécifié comme second argument.

• Assurez-vous qu'il n'y a pas de fichiers .o obsolètes ni de dépendances qui traînent :

  cd linux make mrproper

  Vous devriez maintenant avoir les sources correctement installées.

PRÉREQUIS LOGICIELS

La compilation et l'exécution des noyaux 4.x nécessitent des versions à jour de divers paquets logiciels. Consultez Documentation/Changes pour les numéros de version minimaux requis et comment obtenir des mises à jour pour ces paquets. Attention, l'utilisation de versions excessivement anciennes de ces paquets peut provoquer des erreurs indirectes très difficiles à tracer, alors ne présumez pas que vous pouvez simplement mettre à jour les paquets en cas de problèmes évidents lors de la construction ou de l'exploitation.

RÉPERTOIRE DE CONSTRUCTION pour le noyau :

Lors de la compilation du noyau, tous les fichiers de sortie seront par défaut stockés avec le code source du noyau. L'utilisation de l'option "make O=output/dir" vous permet de spécifier un emplacement alternatif pour les fichiers de sortie (y compris .config). Exemple :

Pour configurer et construire le noyau, utilisez :

Veuillez noter : si l'option 'O=output/dir' est utilisée, elle doit l'être pour toutes les invocations de make.

CONFIGURATION du noyau :

Ne sautez pas cette étape même si vous ne faites que mettre à niveau une version mineure. De nouvelles options de configuration sont ajoutées dans chaque version, et des problèmes étranges apparaîtront si les fichiers de configuration ne sont pas configurés comme prévu. Si vous voulez conserver votre configuration existante pour une nouvelle version avec un minimum de travail, utilisez "make oldconfig", qui ne vous posera que les questions pour les nouvelles options.

• Les commandes de configuration alternatives sont :

  "make config" Interface texte brut.

  "make menuconfig" Menus couleur basés sur le texte, listes radio & boîtes de dialogue.

  "make nconfig" Menus couleur basés sur le texte améliorés.

  "make xconfig" Outil de configuration basé sur X windows (Qt).

  "make gconfig" Outil de configuration basé sur X windows (Gtk).

  "make oldconfig" Réponses par défaut à toutes les questions basées sur le contenu de votre fichier ./.config existant et demande pour les nouveaux symboles de configuration.

  "make silentoldconfig" Comme ci-dessus, mais évite d'encombrer l'écran avec des questions déjà répondues. Met également à jour les dépendances.

  "make olddefconfig" Comme ci-dessus, mais définit les nouveaux symboles à leurs valeurs par défaut sans invite.

  "make defconfig" Crée un fichier ./.config en utilisant les valeurs de symbole par défaut à partir soit de arch/$ARCH/defconfig soit de arch/$ARCH/configs/${PLATFORM}_defconfig, selon l'architecture.

  "make ${PLATFORM}_defconfig" Crée un fichier ./.config en utilisant les valeurs de symbole par défaut à partir de arch/$ARCH/configs/${PLATFORM}_defconfig. Utilisez "make help" pour obtenir la liste de toutes les plateformes disponibles pour votre architecture.

  "make allyesconfig" Crée un fichier ./.config en définissant les valeurs des symboles à 'y' autant que possible.

  "make allmodconfig" Crée un fichier ./.config en définissant les valeurs des symboles à 'm' autant que possible.

  "make allnoconfig" Crée un fichier ./.config en définissant les valeurs des symboles à 'n' autant que possible.

  "make randconfig" Crée un fichier ./.config en définissant les valeurs des symboles à des valeurs aléatoires.

  "make localmodconfig" Crée une configuration basée sur la configuration actuelle et les modules chargés (lsmod). Désactive toute option de module qui n'est pas nécessaire pour les modules chargés.

  root@kitploit:~

                      Pour créer un localmodconfig pour une autre machine,
                      stockez le lsmod de cette machine dans un fichier
                      et passez-le comme paramètre LSMOD.
  
              target$ lsmod > /tmp/mylsmod
              target$ scp /tmp/mylsmod host:/tmp
  
              host$ make LSMOD=/tmp/mylsmod localmodconfig
  
                      Ce qui précède fonctionne également lors de la compilation croisée.
  

  "make localyesconfig" Similaire à localmodconfig, sauf qu'il convertit toutes les options de module en options intégrées (= y).

  Vous pouvez trouver plus d'informations sur l'utilisation des outils de configuration du noyau Linux dans Documentation/kbuild/kconfig.txt.

• NOTES sur "make config" :

  • Avoir des pilotes inutiles rendra le noyau plus gros, et peut dans certaines circonstances entraîner des problèmes : la détection d'une carte contrôleur inexistante peut perturber vos autres contrôleurs.

  • Compiler le noyau avec le "Type de processeur" réglé sur une valeur supérieure à 386 résultera en un noyau qui NE fonctionne PAS sur un 386. Le noyau détectera cela au démarrage et abandonnera.

  • Un noyau avec l'émulation mathématique compilée utilisera toujours le coprocesseur s'il est présent : l'émulation mathématique ne sera simplement jamais utilisée dans ce cas. Le noyau sera légèrement plus gros, mais fonctionnera sur différentes machines, qu'elles aient un coprocesseur mathématique ou non.

  • Les détails de configuration "kernel hacking" entraînent généralement un noyau plus gros ou plus lent (ou les deux), et peuvent même rendre le noyau moins stable en configurant certaines routines pour essayer activement de casser du mauvais code afin de trouver des problèmes du noyau (kmalloc()). Ainsi, vous devriez probablement répondre 'n' aux questions pour les fonctionnalités "développement", "expérimental" ou "débogage".

COMPILATION du noyau :

• Assurez-vous d'avoir au moins gcc 3.2 disponible. Pour plus d'informations, reportez-vous à Documentation/Changes.

  Veuillez noter que vous pouvez toujours exécuter des programmes utilisateur a.out avec ce noyau.

• Exécutez "make" pour créer une image de noyau compressée. Il est également possible de faire "make install" si vous avez lilo installé pour correspondre aux makefiles du noyau, mais vous voudrez peut-être d'abord vérifier votre configuration lilo particulière.

  Pour effectuer l'installation réelle, vous devez être root, mais aucune des constructions normales ne devrait l'exiger. Ne prenez pas le nom de root en vain.

• Si vous avez configuré certaines parties du noyau comme des `modules', vous devrez également faire "make modules_install".

• Sortie de compilation/construction verbeuse du noyau :

  Normalement, le système de construction du noyau fonctionne en mode assez silencieux (mais pas totalement silencieux). Cependant, parfois vous ou d'autres développeurs du noyau avez besoin de voir les commandes de compilation, d'édition de liens ou autres exactement telles qu'elles sont exécutées. Pour cela, utilisez le mode de construction "verbose". Cela se fait en insérant "V=1" dans la commande "make". Par exemple :

  make V=1 all

  Pour que le système de construction indique également la raison de la reconstruction de chaque cible, utilisez "V=2". La valeur par défaut est "V=0".

• Gardez une sauvegarde du noyau à portée de main en cas de problème. C'est particulièrement vrai pour les versions de développement, car chaque nouvelle version contient du nouveau code qui n'a pas été débogué. Assurez-vous de garder également une sauvegarde des modules correspondant à ce noyau. Si vous installez un nouveau noyau avec le même numéro de version que votre noyau de travail, faites une sauvegarde de votre répertoire de modules avant de faire "make modules_install".

  Alternativement, avant la compilation, utilisez l'option de configuration du noyau "LOCALVERSION" pour ajouter un suffixe unique à la version régulière du noyau. LOCALVERSION peut être défini dans le menu "General Setup".

• Pour démarrer votre nouveau noyau, vous devrez copier l'image du noyau (par exemple .../linux/arch/i386/boot/bzImage après compilation) à l'endroit où se trouve votre noyau amorçable habituel.

• Le démarrage d'un noyau directement depuis une disquette sans l'aide d'un chargeur d'amorçage comme LILO n'est plus supporté.

  Si vous démarrez Linux depuis le disque dur, il est probable que vous utilisiez LILO, qui utilise l'image du noyau spécifiée dans le fichier /etc/lilo.conf. Le fichier image du noyau est généralement /vmlinuz, /boot/vmlinuz, /bzImage ou /boot/bzImage. Pour utiliser le nouveau noyau, sauvegardez une copie de l'ancienne image et copiez la nouvelle image par-dessus l'ancienne. Ensuite, vous DEVEZ RÉEXÉCUTER LILO pour mettre à jour la carte de chargement !! Sinon, vous ne pourrez pas démarrer la nouvelle image du noyau.

  La réinstallation de LILO consiste généralement à exécuter /sbin/lilo. Vous pouvez souhaiter éditer /etc/lilo.conf pour spécifier une entrée pour votre ancienne image du noyau (par exemple /vmlinux.old) au cas où la nouvelle ne fonctionnerait pas. Consultez la documentation de LILO pour plus d'informations.

  Après avoir réinstallé LILO, tout devrait être en ordre. Éteignez le système, redémarrez et profitez-en !

  Si vous avez besoin de modifier le périphérique racine par défaut, le mode vidéo, la taille du disque ram, etc. dans l'image du noyau, utilisez le programme 'rdev' (ou alternativement les options de démarrage LILO le cas échéant). Pas besoin de recompiler le noyau pour modifier ces paramètres.

• Redémarrez avec le nouveau noyau et profitez.

EN CAS DE PROBLÈME :

• Si vous rencontrez des problèmes qui semblent être dus à des bogues du noyau, veuillez vérifier le fichier MAINTAINERS pour voir s'il y a une personne particulière associée à la partie du noyau avec laquelle vous avez des problèmes. S'il n'y a personne listé là, la deuxième meilleure chose est de m'envoyer un courriel ([email protected]), et éventuellement à toute autre liste de diffusion pertinente ou au groupe de discussion.

• Dans tous les rapports de bogue, veuillez indiquer de quel noyau vous parlez, comment reproduire le problème et quelle est votre configuration (utilisez votre bon sens). Si le problème est nouveau, dites-le moi, et si le problème est ancien, essayez de me dire quand vous l'avez remarqué pour la première fois.

• Si le bogue donne lieu à un message comme

  unable to handle kernel paging request at address C0000010 Oops: 0002 EIP: 0010:XXXXXXXX eax: xxxxxxxx ebx: xxxxxxxx ecx: xxxxxxxx edx: xxxxxxxx esi: xxxxxxxx edi: xxxxxxxx ebp: xxxxxxxx ds: xxxx es: xxxx fs: xxxx gs: xxxx Pid: xx, process nr: xx xx xx xx xx xx xx xx xx xx xx

  ou des informations de débogage similaires du noyau sur votre écran ou dans votre journal système, veuillez le reproduire exactement. Le dump peut sembler incompréhensible pour vous, mais il contient des informations qui peuvent aider à déboguer le problème. Le texte au-dessus du dump est également important : il explique pourquoi le noyau a dumpé du code (dans l'exemple ci-dessus, c'est dû à un mauvais pointeur du noyau). Plus d'informations sur la façon de comprendre le dump se trouvent dans Documentation/oops-tracing.txt

• Si vous avez compilé le noyau avec CONFIG_KALLSYMS, vous pouvez envoyer le dump tel quel, sinon vous devrez utiliser le programme "ksymoops" pour comprendre le dump (mais compiler avec CONFIG_KALLSYMS est généralement préférable). Cet utilitaire peut être téléchargé depuis ftp://ftp..kernel.org/pub/linux/utils/kernel/ksymoops/ . Alternativement, vous pouvez effectuer la recherche du dump manuellement :

• Dans les dumps de débogage comme ci-dessus, il est extrêmement utile si vous pouvez rechercher ce que signifie la valeur EIP. La valeur hexadécimale en tant que telle ne m'aide pas beaucoup, ni personne d'autre : elle dépendra de votre configuration particulière du noyau. Ce que vous devriez faire est de prendre la valeur hexadécimale de la ligne EIP (ignorez le "0010:"), et de la rechercher dans la liste de noms du noyau pour voir quelle fonction du noyau contient l'adresse incriminée.

  Pour trouver le nom de la fonction du noyau, vous aurez besoin de trouver le binaire système associé au noyau qui a présenté le symptôme. C'est le fichier 'linux/vmlinux'. Pour extraire la liste de noms et la faire correspondre à l'EIP du crash du noyau, faites :

  nm vmlinux | sort | less

  Cela vous donnera une liste d'adresses du noyau triées par ordre croissant, à partir de laquelle il est simple de trouver la fonction qui contient l'adresse incriminée. Notez que l'adresse donnée par les messages de débogage du noyau ne correspondra pas nécessairement exactement aux adresses des fonctions (en fait, c'est très peu probable), donc vous ne pouvez pas simplement 'grep' la liste : la liste vous donnera cependant le point de départ de chaque fonction du noyau, donc en cherchant la fonction qui a une adresse de départ inférieure à celle que vous recherchez mais qui est suivie d'une fonction avec une adresse plus élevée, vous trouverez celle que vous voulez. En fait, il peut être bon d'inclure un peu de "contexte" dans votre rapport de problème, en donnant quelques lignes autour de celle intéressante.

  Si pour une raison quelconque vous ne pouvez pas faire ce qui précède (vous avez une image de noyau pré-compilée ou similaire), me donner autant d'informations que possible sur votre configuration aidera. Veuillez lire le document REPORTING-BUGS pour plus de détails.

• Alternativement, vous pouvez utiliser gdb sur un noyau en fonctionnement. (lecture seule ; c'est-à-dire que vous ne pouvez pas modifier les valeurs ou définir des points d'arrêt.) Pour ce faire, compilez d'abord le noyau avec -g ; modifiez arch/i386/Makefile de manière appropriée, puis faites un "make clean". Vous devrez également activer CONFIG_PROC_FS (via "make config").

  Après avoir redémarré avec le nouveau noyau, faites "gdb vmlinux /proc/kcore". Vous pouvez maintenant utiliser toutes les commandes gdb habituelles. La commande pour rechercher le point où votre système s'est planté est "l *0xXXXXXXXX". (Remplacez les XXX par la valeur EIP.)

  gdb sur un noyau non en fonctionnement échoue actuellement car gdb (à tort) ignore le décalage de départ pour lequel le noyau est compilé.