Genkernel/fr

genkernel est utilisé pour automatiser le processus de compilation du   noyau et du système de fichiers virtuel de démarrage (initramfs). Parmi les fonctionnalités citons :
 * la configuration des sources du noyau
 * la compilation de l'image compressée du noyau  et sa copie dans
 * la création d'un système de fichiers virtuel du démarrage (initramfs) et sa copie dans
 * la création des liens symboliques dans
 * l'ajout d'un contenu personnalisé au système de fichiers virtuel de démarrage (initramfs) comme par exemple les fichiers relatifs au chiffrage, les écrans d'attente, les modules supplémentaires et plus encore.
 * la compression de l'initramfs
 * la configuration du chargeur de démarrage

Installation
Pour installer le paquet, commencez par sélectionner les options de la variable USE appropriées.

Ensuite, vous pouvez procéder à l'installation du paquet genkernel.

Invocation de Genkernel
La forme générale de l'invocation de genkernel est la suivante :

Options
Le comportement réel de genkernel dépend d'une grande variété d'options, dont la majorité peut être activée/désactivée dans le fichier ou passer avec la commande. Les options passées en ligne de commande prévalent sur celles définies dans. Ce fichier est très bien documenté. Nous examinerons néanmoins ici quelques unes des options les plus communes. Pour une information plus complète, reportez-vous aux commentaires du fichier ou à la sortie de la commande.

Options agissant sur l'interactivité de l'utilisateur
Les options de configuration listées ci-dessous permettent de décider comment interagir avec le processus de configuration. L'utilisateur peut même décider si le fichier de configuration sera ou pas sauvegardé. Les options suivantes sont les options de configuration de premier ordre :


 * --[no-]menuconfig
 * Active [ or désactive] la commande   (qui invoque un menu interactif de configuration) avant de compiler le noyau.


 * --gconfig
 * fournit un outil de configuration du noyau qui dépend des bibliothèques GTK+. L'avantage de cette option est que la majorité des utilisateurs trouvent cette interface plus claire et facile à utiliser pour configurer le noyau, puisqu'elle utilise le système X-Window. Son inconvénient est que vous devez avoir X-Window pour l'utiliser, cela ne marchera pas dans une console en ligne de commande.


 * --xconfig
 * fournit un outil de configuration du noyau qui dépend des bibliothèques Qt. L'avantage de cette option est que la majorité des utilisateurs trouvent cette interface plus claire et facile à utiliser pour configurer le noyau, puisqu'elle utilise le système X-Window. Son inconvénient est que vous devez avoir X-Window pour l'utiliser, cela ne marchera pas dans une console en ligne de commande.


 * --[no-]save-config
 * sauvegarde [ou ne sauvegarde pas] la configuration du noyau dans un fichier situé dans le répertoire pour une future utilisation.


 * --kernname=&lt;NickName&gt;: vous permet de nommer le noyau et le disque virtuel initial (initrd).qui seront copiés dans, de sorte que les noms de fichier produits soient kernel-Nom-version et initramfs-Nom-version.

Options agissant sur le système résultant
Les options définies ici définissent quelles fonctionnalités, seront, ou ne seront pas, incluses dans le noyau et le système de fichiers virtuel de démarrage résultants.


 * --[no-]splash
 * ajoute [ou n'ajoute pas] la prise en charge de l'écran d'attente en tampon de trame (splash framebuffer) au sytème de fichiers virtuel de démarrage (initrd) que construit genkernel. Pour écraser le thème par défaut utilisé par fbsplash, utilisez --splash=&lt;MonThème&gt; (où &lt;MonThème&gt; est le nom de l'un des répertoires situés dans ).


 * --splash-res=&lt;PreferredResolution&gt;</tt>
 * cette option vous permet de sélectionner les résolutions prise en charge par l'initrd au démarrage. Elle est utile pour deux raisons : d'abord, vous pouvez choisir quelles résolutions sont prises en charge spécifiquement par votre système, ensuite, vous réduisez la quantité d'espace occupée par l'initrd puisque ce dernier n'a plus à s'occuper des résolutions que vous n'utiliserez pas. Cependant, vous pouvez ignorer cette option si vous compilez un noyau pour un CD d'installation, ce qui permettra à bootsplash de prendre en charge toutes les résolutions.


 * --do-keymap-auto</tt>
 * force la sélection de l'arrangement de clavier lors du démarrage.


 * --lvm</tt>
 * inclut la prise en charge des volumes gérés par LVM2 grâce à des binaires statiques, s'ils sont disponibles. Les binaires (statiques) LVM2 en question sont compilés lorqu'ils manquent. Assurez-vous d'avoir installé le paquet lvm2 sur votre système avec emerge lvm2 avant d'activer cette option et d'avoir lu l'article LVM sur ce wiki.


 * --dmraid</tt>
 * inclut la prise en charge de DMRAID, l'outil qui crée des volumes RAID logiciels en utilisant le sous-système device-mapper du noyau. DMRAID découvre, active, désactive et affiche les propriétés des volumes RAID (ATARAID par exemple) ainsi que celles des partition DOS incluses.


 * --luks</tt>
 * inclut le support de Linux Unified Key Setup (LUKS). Cela vous permettra d'utiliser un périphérique chiffré par LUKS pour placer votre système de fichiers racine (/). Spécifiez alors au chargeur de démarrage le nom de ce périphérique via la variable   (  doit être le nom du périphérique une fois déchiffré par LUKS).


 * --disklabel</tt>
 * ajoute la prise en charge de disk label (étiquette de disque) and UUID (Identifiant Unique Universel) à votre disque virtuel initial (initrd).


 * --iscsi</tt>
 * ajoute la prise en charge de iSCSI à votre disque virtuel initial (initrd).


 * --multipath</tt>
 * ajoute la prise en charge de Multipath à votre disque virtuel initial (initrd).


 * --linuxrc=/path/to/your/linuxrc</tt>
 * spécifie un script linuxrc créé par l'utilisateur qui sera appelé lors de la phase de démarrage du noyau, avant le démarrage du système. (Un script linuxrc par défaut devrait se trouver dans .) Ce script vous permet d'amorcer sur un petit noyau modulaire et de charger les pilotes requis (sous forme de modules) par le système avant le démarrage.


 * --cachedir=/path/to/alt/dir</tt>
 * remplace le chemin par défaut du cache utilisé pendant la compilation.


 * --tempdir=/path/to/new/tempdir</tt>
 * spécifie le chemin du répertoire temporaire utilisé par genkernel lors de la compilation du noyau.


 * --unionfs</tt>
 * inclut la prise en charge de Unification File System dans votre disque virtuel initial (initrd).


 * --mountboot</tt>
 * détecte si le répertoire   a besoin d'être monté en lisant le  et en y prenant les instructions sur la manière de le monter.

Options agissant sur le choix des outils utilisés pour la compilation
Les options suivantes sont prises en charge par genkernel, et sont passées aux applications concernées lors de la compilation et de l'assemblage du noyau. Ces options influent sur le choix des outils utilisés pendant le processus de compilation, quoi qu'à un niveau assez bas.


 * --kernel-cc=&lt;unCompilateur&gt;</tt>
 * ceci spécifie quel compilateur sera utilisé pour construire votre noyau


 * --kernel-ld=&lt;unéditeurDeLiens&gt;</tt>
 * ceci spécifie quel éditeur de liens sera utilisé dans la construction de votre noyau.


 * --kernel-as=&lt;unAssembleur&gt;</tt>
 * ceci spécifie quel assembleur sera utilisé pour construire votre noyau.


 * <tt>--kernel-make=&lt;unMake&gt;</tt>
 * ceci spécifie un utilitaire GNU make alternatif qui sera utilisé pour la construction de votre noyau.


 * <tt>--utils-cc=&lt;unCompilateur&gt;</tt>
 * ceci spécifie un compilateur qui sera utilisé pour construire les outils annexes.


 * <tt>--utils-ld=&lt;unÉditeurDeLiens&gt;</tt>
 * ceci spécifie un éditeur de liens utilisé dans la construction des outils annexes.


 * <tt>--utils-as=&lt;unAssembleur&gt;</tt>
 * ceci spécifie un assembleur qui sera utilisé pour construire les outils annexes.


 * <tt>--utils-make=&lt;unMake&gt;</tt>
 * ceci spécifie un utilitaire GNU make alternatif qui sera utilisé pour la construction des outils annexes..


 * <tt>--makeopts=-jX</tt>
 * spécifie le nombre de fils d'exécution concurrents que make peut utiliser pendant la compilation du noyau et des outils. La variable  est un nombre obtenu en ajoutant un (1) au nombre de processeurs du système. Pour un système monoprocesseur, la valeur appropriée serait   . Un biprocesseur utiliserait    et ainsi de suite. Un système monoprocesseur qui prend en charge la technologie Hyper-Threading™ (ou « HT ») peut utiliser la valeur  , en supposant que le support du SMP (Symmetric Multi-Processing) soit activé dans le noyau au moment de la compilation.

Options agissant sur le processus de compilation
Les options suivantes ont généralement un effet lors de la compilation réelle.


 * <tt>--kerneldir=/chemin/vers/sources/</tt>
 * pour spécifier l'endroit où se trouvent les sources du noyau et ne pas utiliser l'emplacement par défaut.


 * <tt>--kernel-config=/chemin/vers/fichier/config-file</tt>
 * pour spécifier l'endroit où se trouve le fichier de configuration et ne pas utiliser l'emplacement par défaut.


 * <tt>--module-prefix=/chemin/vers/modules prefix/</tt>
 * pour spécifier où installer les modules du noyau et ne pas utiliser l'emplacement par défaut.


 * <tt>--[no-]clean</tt>
 * lance [ou ne lance pas] make clean avant de compiler le noyau, ce qui efface toutes les dépendances et fichiers objets déjà présents.


 * <tt>--[no-]mrproper</tt>
 * lance [ou ne lance pas] make mrproper avant de compiler le noyau. Comme la commande make clean, make mrproper efface toutes les dépendances et fichiers objets de l'arborescence des sources du noyau, mais elle efface également les fichiers de configuration (tels que ou ).


 * <tt>--oldconfig</tt>
 * Lance la commande, qui essaira de collecter des informations de configuration pour votre architecture depuis un script générique situé dans . Ce processus n'est pas interactif ; aucune entrée de l'utilisateur n'est demandée. De plus, si <tt>--oldconfig</tt> est utilisé en même temps que <tt>--clean</tt>, cette dernière sera annulée, comme si on avait rajouté l'option  <tt>--no-clean</tt>.


 * <tt>--callback="echo hello"</tt>
 * cette routine effectue un appel à l'argument spécifié (ici, echo Hello) après que le noyau et les modules correspondants aient été construits, mais avant de créer l'image initrd. C'est utile lorsque vous souhaitez installer des modules externes dans l'initrd en passant la commande emerge en argument et redéfinir de ce fait un nouveau groupe de modules genkernel.


 * <tt>--[no-]install</tt>
 * lance [ou ne lance pas] la commande, ce qui installe votre nouveau noyau, le fichier de configuration, l'image initrd et le System.map sur votre partition montée de boot. Les modules compilés seront aussi installés..


 * <tt>--no-ramdisk-modules</tt>
 * empêche la copie des modules dans l'image de disque intitial (initrd) créée par genkernel.


 * <tt>--all-ramdisk-modules</tt>
 * copie tous les modules disponibles dans l'image de disque initial (initrd) créée par genkernel.


 * <tt>--genzimage</tt>
 * crée l'image initrd avant l'image du noyau (cette bidouille ne s'applique actuellement qu'aux systèmes PPC Pegasos.)

Options de débogage
L'utilisation d'options de débogage pendant la compilation du noyau contrôle le nombre d'informations reportées, ainsi que la présentation de celles-ci.


 * <tt>--loglevel=&lt;niveau de verbosité&gt;</tt>
 * contrôle le niveau de verbosité des informations fournies par genkernel. La variable NiveauVerbosité doit être un nombre entier compris entre 0 et 5. Le niveau « 0 » représentant le minimum d'information, tandis qu'une valeur de « 5 » fournira le plus d'informations possible sur le déroulement des opérations.


 * <tt>--logfile=/chemim/vers/fichier/journal</tt>
 * ignore la valeur de <tt>--loglevel</tt> et renvoie toutes les informations produites par genkernel vers le fichier spécifié, qui est  par défaut.


 * <tt>--[no-]color</tt>
 * active [ou désactive] la sortie colorée des informations de débogage (celles reportées par genkernel).

Action
Une action passée avec la commande  indique à    ce qu'il faut faire. Les actions prises en charge sont :


 * compile/construit toutes les étapes — le disque virtuel initial (initrd), l'image du noyau et les modules.
 * compile/construit toutes les étapes — le disque virtuel initial (initrd), l'image du noyau et les modules.


 * ne compile/construit que l'image du noyau.
 * ne compile/construit que l'image du noyau.


 * : ne compile/construit que l'image du noyau et les modules


 * ne compile/construit que le disque virtuel initial(initramfs)
 * ne compile/construit que le disque virtuel initial(initramfs)


 * ne compile/construit que le disque virtuel initial(initramfs)
 * ne compile/construit que le disque virtuel initial(initramfs)

Première invocation de Genkernel
Bien qu'il y ait plusieurs façons de lancer genkernel, la plus simple reste. Une configuration générique qui marche correctement pour tous les systèmes sera alors utilisée. Comme mentionné précédemment, cette méthode n'est pas sans inconvénients. La plupart des modules compilés ne seront pas utilisés et la compilation prendra beaucoup de temps. L'illustration suivante montre une approche plus efficace, en passant certains paramètres à genkernel en tant qu'utilisateur root:

Cette opération indique à genkernel de créer un noyau avec un écran de démarrage (<tt>--splash</tt>) en tampon de trames (framebuffer) qui devra être installé à la main (<tt>--no-install</tt>). Dans la phase préparatoire de compilation, genkernel n'effacera pas les objets déjà compilés (<tt>--no-clean</tt>). Enfin, un menu de configuration sera affiché, permettant à l'utilisateur de choisir quels modules seront compilés (<tt>--menuconfig</tt>).

Remplacez <tt>--no-install</tt> par <tt>--install</tt> pour qu'il installe automatiquement le nouveau noyau dans et spécifiez <tt>--symlink</tt> pour qu'il crée les liens symboliques pour vous. En utilisant le paramètre -- <tt>--mountboot</tt>, la partition sera monté par genkernel automatiquement, si nécessaire.

Utiliser Genkernel pour modifier votre noyau
La première chose que vous devriez faire, c'est autoriser le lancement de  dans le fichier  :

Gestion des fichiers par genkernel
Quand il utilise genkernel, l'utilisateur doit être conscient de quelques aspects concernant la gestion des fichiers de configuration et des fichiers image du noyau, ainsi que de la façon dont les sources du noyau sont manipulées par le système.

Fichiers sources utilisés par genkernel
Après une commande, chaque fois que de nouvelles sources sont disponibles, un nouveau dossier est créé pour les sources du noyau dans   pour les héberger. Normalement, le dossier des sources actives est pointé par le lien symbolique.

Le dossier  pourrait ressembler à ceci :

Le lien symbolique  peut être changé de différentes manières.


 * Si l'option  de la variable USE est définie dans, le lien symbolique  est automatiquement mis à jour pour pointer sur les nouvelles sources installées par la commande  ..


 * Si l'option de la variable USE évoquée ci-dessus n'est pas définie, l'utilisateur peut changer la destination du lien symbolique en utilisant la commande.

Quoi qu'il en soit,  utilise toujours les sources pointées par ce lien symbolique.

Fichiers de configuration du noyau utilisé par genkernel
Si une compilation du noyau a déjà été faite à partir des sources actives du noyau, il devrait y avoir un fichier dans le dossier qui contient la configuration du noyau qui a été appliquée lors de la création de la dernière bzimage du noyau. Ce fichier est nommé par exemple ; nom dans lequel il faut remplacer x86_64 par votre achitecture, 3.7.9 par la version des sources que vous utilisez et r1 par le numéro de divulgation de vos sources.

C'est ce fichier  qui est utilisé comme point de départ de la configuration lorsque vous lancez  .

Si c'est la première fois que vous lancez, ou si la précédente configuration n'a pas été sauvegardée, ce fichier est remplacé par une configuration par défaut qui réside dans  (nom dans lequel x86_64 doit être remplacé par votre architecture réelle).

Sauvegarder la configuration compilée
Si l'option   de genkernel est activée, soit depuis la ligne de commande, soit dans , la configuration compilée du noyau est sauvegardée (avec le nom donné ci-dessus) dans le dossier. En même temps, la configuration est sauvegardée dans le fichier  dans le dossier   mais ce n'est pas ce fichier qui est réutilisé lors de l'exécution suivante de.

Installer le noyau et le disque virtuel de démarrage dans le dossier /boot
L'action  spécifiée lors de l'invocation de  genkernel, demande à    d'installer les images du noyau et du système de fichiers virtuel de démarrage (initramfs) dans le dossier. Afin de le faire d'une manière appropriée, définissez ce qui suit dans le fichier  :


 * Le premier paramètre parle de lui-même.


 * Le second paramètre indique à genkernel de sauvegarder la configuration du noyau compilé dans.


 * Les deux dernières options indiquent à genkernel de mettre la configuration de grub à jour. En pratique, voilà ce qui se passe :
 * si une image précédente du noyau avec le même nom existe déjà, elle est renommée en ajoutant <tt>.old</tt> à son nom. Un lien symbolique   est automatiquement créé qui pointe sur lui.
 * le nouveau noyau prend la place de tout noyau de même nom dans le dossier . Si c'est la première fois que le noyau est compilé, un lien symbolique est automatiquement créé qui pointe sur le nouveau noyau.

Après l'exécution de la commande , le dossier   pourrait ressembler à ceci :

Configurer le chargeur de démarrage
Les liens symboliques présentées plus haut peuvent être utilisés pour configurer le chargeur de démarrage, de telle manière que même si le nouveau noyau n'est pas amorçable, l'utilisateur puisse toujours redémarrer sur l'ancien.

Pour permettre au nouvea noyau et au nouveau système de fichiers virtuel de démarrage produit par genkernel de fonctionner correctement, il faut fournir un minimum d'informations dans le fichier de configuration du chargeur de démarrage :
 * Ajoutez   aux paramètres passés à l'image du noyau, avec  pointant sur la partition racine.
 * Si splash est utilisé, ajoutez un mode line convenable tel que   aux  paramètres passés au noyau et ajoutez aussi     ou   selon la loquacité attendue dans le processus de démarrage.
 * Ajoutez l'information initrd information requise par le chargeur de démarrage. Consultez le  chapitre sur la configuration du chargeur de démarrage du manuel de Gentoo pour les détails sur comment rendre votre chargeur de démarrage informé de la présence de initrd.

Voici à quoi le fichier  pourrait ressembler.

Préserver vos fichiers qui fonctionnent
L'application genkernel sauvegarde automatiquement les changements des fichiers. Si les changements précédents doivent être sauvegardés, les actions suivantes sont à envisager.


 * Le premier fichier à préserver est le fichier de configuration du noyau dans . Si les sources n'ont pas changées avant la recompilation du noyau, le nom utilisé précédemment pour ce fichier sera utilisé à nouveau. C'est pourquoi dupliquer le fichier de configuration précédent avec un nouveau nom aide à préserver l'information tout en laissant l'ancien fichier disponible  comme point de départ de la nouvelle configuration.


 * La deuxième chose importante à préserver ce sont les images des noyaux et initramfs déjà amorçables. La manière de le faire dépend du contexte :
 * Si le dernier noyau compilé est amorçable, exécuter   renommera cette image du noyau(et de façon similaire celle de l'image initramfs) en   et créera une nouvelle image . Ceci signifie que, même si le nouveau noyau n'est pas amorçable, l'utilisateur sera toujours en mesure de démarrer sur l'ancien.
 * Si le dernier noyau compilé n'est pas amorçable et si les sources n'ont pas été changées depuis que l'utilisateur en a compilé un qui était amorçable, avant d'exécuter, commencez par effacer la nouvelle image du noyau et supprimer le suffixe <tt>.old</tt>  du nom du dernier noyau amorçable. Sans cela si le nouveau noyau n'est pas amorçable pour la deuxième fois, le  amorçable sera évincé par le renommage du  , laissant l'utilisateur avec un système non amorçablex Tenez le même raisonnement pour initramfs.

Utiliser la configuration précédente du noyau tout en changeant de sources
La configuration précédente peut être utilisée via l'option   dans le fichier  comme ci-après :

Démarrer sur un CD-ROM d'installation Gentoo depuis le réseau
L'outil genkernel peut fabriquer des images de noyaux et de disque virtuel initial (initrd) qui permettent de démarrer sur le réseau (netboot). Avec un peu de chance, vous devriez pouvoir faire démarrer n'importe quel ordinateur récent par le réseau sur l'environnement fourni par le CD-ROM d'installation de Gentoo.

La magie de la chose réside dans le script linuxrc de genkernel : il va essayer de monter le CD-ROM d'installation par NFS via le réseau. Partant de là, les scripts d'initialisation du CD-ROM d'installation seront utilisés comme si le CD était présent en local.

Building Kernel and Initrd Images with Support for Netbooting
To enable support for netbooting, include the following options while configuring the kernel:

First, the kernel image must include the drivers for your Network Interface Cards (NIC). Normally, drivers for such devices will be compiled as modules. However, it is essential (for netbooting) that such drivers are compiled directly into the kernel image and not as modules.

Be sure to select <tt>&lt;*&gt;</tt> and not <tt>&lt;M&gt;</tt>.

Secondly, it is suggested that IP: kernel level autoconfiguration is enabled as well as IP: DHCP support options. This avoids an unnecessary layer of complexity since the IP address and the NFS path to the Installation CD can be configured on a DHCP server. Of course, this means the kernel command line will remain constant for any machine — which is very important for etherbooting.

These options tell the kernel to send a DHCP request at bootup.

Additionally, enable SquashFS because most modern Gentoo Installation CDs require it. Support for SquashFS is not included with the generic kernel source tree. To enable SquashFS, apply the necessary patches to the generic kernel source or install gentoo-sources.

Once the compilation process is completed, create a compressed tarball (tar.gz) that contains the kernel's modules. This step is only necessary if the kernel version does not match the kernel image version on the Installation CD.

To create an archive containing all the modules:

Depending on the network boot mechanism, one of the following steps need to be followed:

To create an etherboot image:

To create a OpenBoot / SPARC64 TFTP image:

The file is the boot image.

Finally, copy this kernel to the TFTP server. The details are architecture-dependent and are beyond the scope of this guide. Please refer to the documentation for your platform.

NFS setup
To setup a NFS share that contains the Installation CD, use the loop device to mount the ISO image and then copy the contents of the CD into the NFS share. As a nice extra, genkernel's initrd scripts will extract all tar.gz files located in the directory. All that needs to be done here is copy the archive to the  directory.

The following assumes that is an exported NFS share:

Now copy the file into :

DHCP setup
The netboot images will ask the DHCP server on the network for an IP as well as a <tt>root-path</tt> parameter. Both can be specified per host using a MAC address to identify machines:

Netbooting Instructions
Netbooting itself is again very platform-specific. The important part is to specify the  and   parameters on the kernel command line, as this will bring up the network interface and tell the initrd scripts to mount the Installation CD via NFS. Here are some platform-specific tips.

For etherboot, insert the etherboot disk into the drive and reboot. The kernel command line was specified when the image was constructed. With Sparc64, hit - at the boot prompt and enter:

For PXE, setup pxelinux (part of syslinux), then create a along the lines of:

Introduction
If an initramfs is installed with genkernel, then take a look at the various boot options that can (or should) be defined in the bootloader configuration. The most common ones are added to this guide.

Loading LVM or software-RAID
If the system uses LVM or software-RAID, the initramfs has to be built using the <tt>--lvm</tt> and <tt>--mdadm</tt> options. Don't forget to enable support during boot as well. This can be done using the dolvm and domdadm options.

Booting in single-user mode
If for some reason boot-up fails, rescuing the system by booting in the single-user mode is still possible. This will only load the really necessary services and then drop the user to a rescue (root) shell.

Acknowledgements
We would like to thank the following authors and editors for their contributions to this guide:


 * Tim Yamin
 * Jimi Ayodele
 * Thomas Seiler
 * Joshua Saddler
 * Sebastian Pipping
 * José Fournier