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
The actual behavior of genkernel depends on a large variety of options, the majority of which can be set/unset in the file or passed via  the genkernel command. Options passed over the command line take precedence over options defined into. This file is very well documented but let's examine some of the most commonly used ones here. For a more complete explanation, please refer to the comments in itself or to the output of the man genkernel command.

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
 * Activates [ or deactivates] the make menuconfig command (which invokes an interactive configuration menu) before building the kernel.


 * --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 Fbsplash (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>
 * Activates [or deactivates] the make clean command before compiling your kernel. The make clean command removes all object files and dependencies from the kernel's source tree.


 * <tt>--[no-]mrproper</tt>
 * Activates [or deactivates] the make mrproper command before kernel compilation. Like the make clean command, make mrproper removes all object files and dependencies from the kernel's source tree. However, any previous configuration files (in or ) will also be purged from the kernel's source tree.


 * <tt>--oldconfig</tt>
 * Issues the make oldconfig command, which attempts to collect configuration information for the system's architecture from a generic script in . This is a non-interactive process; no user input is entertained. Also, if <tt>--oldconfig</tt> is used in conjunction with <tt>--clean</tt>, the latter option is negated, resulting in the activation of the <tt>--no-clean</tt> option.


 * <tt>--callback="echo hello"</tt>
 * Calls the specified arguments ( echo hello, in this case) after the kernel and the relevant modules have been built, but before building the initrd image. This may be useful if you want to install external modules in the initrd image by emerging the relevant item(s) with the callback feature, and then redefining a genkernel module group.


 * <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
The action passed on the command line with the <tt>genkernel [options …] action</tt> command, tells genkernel what to do. The following <tt>actions</tt> are supported:


 * all
 * Builds all stages — the initrd, kernel image and modules.


 * bzImage
 * Only builds the kernel image


 * kernel
 * Only builds the kernel image and modules


 * initramfs
 * Only builds the initramfs/ramdisk image


 * ramdisk
 * Only builds the initramfs/ramdisk image

Première invocation de Genkernel
Although there are several ways to run genkernel, the least-intrusive approach recommended for most users is provided by genkernel all. Here, a generic configuration which works well for most systems is used. As was mentioned earlier, this approach is not without drawbacks; most of the modules created are useless to the average user and may increase compile time. Below is an illustration of a more efficient approach, achieved by passing certain options to genkernel as 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
The first thing that should be done is to allow the triggering of make menuconfig in the file:

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
After an emerge -u gentoo-sources, whenever new sources are available, a new kernel source directory is created under to host them. Normally, the active kernel sources directory is pointed to by the symlink.

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  ..


 * If the previous USE flag is not set, the user can change the destination of the symlink using the eselect kernel list command.

Whatever it is, genkernel always uses the sources pointed by this symlink.

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.

It is this file that is used as a starting configuration when running  genkernel --menuconfig all.

If it is the first time that genkernel is run with the new kernel sources, or if the previous result has not been saved, this file is substituted with a default configuration file that resides at where x86_64 is substituted with the actual architecture.

Sauvegarder la configuration compilée
If the <tt>save-config</tt> genkernel option is activated, either from the command line or inside, the compiled kernel configuration is saved (with the name given above) into the  directory. At the same time, the configuration is saved in the file in  directory but this file is not reused on the next genkernel all run.

Installer le noyau et le disque virtuel de démarrage dans le dossier /boot
The <tt>all</tt> action specified when invoking genkernel, ask genkernel to install the kernel image and the initramfs into the directory. In order to do it in a convenient manner, set the following in the  file:


 * 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.

After running genkernel --menuconfig all, the directory might look like this:

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.


 * The second important thing is to preserve the already bootable kernel and initramfs images. The way to accomplish this depends on the context:
 * If the last kernel compiled is bootable, running genkernel will rename this kernel (and similarly initramfs) image to and create a new . This mean that even if the new kernel is not bootable, users will always be able to boot the old one.
 * If the last kernel compiled is not bootable and sources haven't changed since the user compiled a bootable one, prior to running genkernel, first delete the new kernel image and remove the <tt>.old</tt> suffix from the last bootable one. Without this, if the newly compiled kernel is not bootable for the second time, the bootable will be kicked out by the renaming of the non bootable , giving the user an unbootable system. Use the same reasoning for initramfs.

Utiliser la configuration précédente du noyau tout en changeant de sources
The previous configuration can be used through the make menuconfig option in your as follows:

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.

Construire un noyau et an initrd qui prennent en charge le démarrage par le réseau
Pour activer le support du démarrage par le réseau, activez les options suivantes lors de la configuration du noyau :

Tout d'abord, l'image du noyau doit contenir les pilotes de votre carte réseau. En principe, les pilotes pour ce genre de périphériques sont compilés en tant que modules. Pourtant, il est impératif ici (pour pouvoir démarrer avec) que ces pilotes soient intégrés dans le noyau et pas en modules.

Assurez-vous de choisir <tt>&lt;*&gt;</tt> et non pas <tt>&lt;M&gt;</tt>.

Ensuite, nous vous suggérons d'activer IP: kernel level autoconfiguration et IP: DHCP support. Cela évitera une couche supplémentaire de complexité si l'adresse IP et le chemin NFS du CD-ROM d'installation peuvent être spécifiés par un serveur DHCP. Bien sûr, cela signifie que la ligne de commande d'appel du noyau sera la même pour toutes les machines.

Ces options indiquent au noyau d'envoyer une requête DHCP au démarrage.

De plus, vous devez activer SquashFS car la majorité des CD-ROM d'installation récents de Gentoo l'utilisent. Le support de SquashFS n'est pas intégré aux sources génériques de Linux, vous devrez appliquer les correctifs nécessaires ou bien installer les gentoo-sources.

Une fois que le processus de compilation est terminé, créez une archive compressée (.tar.gz) qui contient les modules du noyau. Cette étape n'est nécessaire que si la version de votre noyau ne correspond pas à la version de l'image située sur le CD-ROM d'installation.

Pour créer une archive contenant tous les modules :

Selon votre méthode de démarrage par le réseau, vous devrez exécuter certaines des étapes suivantes :

Créer une image etherboot.

Pour créer une image TFTP OpenBoot / SPARC64.

Le fichier est l'image à démarrer.

Enfin, copiez ce noyau sur votre serveur TFTP. La manière de procéder dépend complètement de votre architecture et dépasse les limites de ce guide. Veuillez consulter la documentation de votre plate-forme.

Configuration du NFS
Pour mettre en place un partage NFS qui contient le CD-ROM d'installation, utilisez un périphérique de bouclage (loop device) pour y monter l'image ISO et copiez le contenu du CD dans le partage NFS. En bonus, le script initrd de genkernel désarchivera tous les fichiers .tar.gz situés dans le répertoire. Tout ce qu'il vous reste à faire est de copier votre archive  dans le répertoire.

En supposant que  soit un partage NFS.

Copiez dans

Configuration du DHCP
Les images netboot demanderont une adresse IP et un chemin NFS à votre serveur DHCP. Ces informations peuvent être configurées individuellement en utilisant l'adresse MAC pour identifier les machines :

Utilisation du démarrage par le réseau
Le démarrage par le réseau est encore une fois très spécifique à la plate-forme utilisée. Ce qui est important, c'est de spécifier les paramètres   et   sur la ligne de commande du noyau. Cela activera la carte réseau et montera le CD-ROM d'installation via NFS. Voici quelques astuces pour certaines plates-formes :

Pous etherboot, insérer le disque etherboot dans le lecteur et redémarrez. La ligne de commande du noyau a été spécifiée lors de la construction de l'image. Avec Sparc64, pressez - à l'invite de démarrage et entrez :

For PXE, Configurez pxelinux (qui fait partie de syslinux), puis créez un fichier qui contient ces lignes:

Introduction
Si vous avez installé un disque virtuel initial (initramfs) avec genkernel, vous devriez assurément regarder les options diverses et variées de boot que vous pouvez (ou devez) définir dans la configuration de votre chargeur de démarrage. Les plus courantes sont citées ici pour référence.

Chargement de LVM ou de software-RAID
Si votre système utilise LVM ou RAID logiciel, vous avez sans aucun doute construit le disque virtuel initial (initramfs) en utilisant les options <tt>--lvm</tt> et <tt>--mdadm</tt>. Néanmoins, vous ne devriez pas oublier d'activer la prise en charge au moment du démarrage. Ceci peut être fait en utilisant les options dolvm et domdadm.

Démarrer dans le mode utilisateur unique (single-user)
Si, pour une raison ou une autre, le démarrage échoue, récupérer le système en démarrant le mode utilisateur unique reste possible. Ceci ne chargera que les services réellement nécessaires et offrira à l'utilisateur un shell de récuppration root.