Genkernel/fr

est noyau et du système de fichiers virtuel de démarrage (initramfs).]] Parmi ses fonctionnalités, on peut citer :


 * Configurer les sources du noyau
 * Compiler le noyau, le compresser, et le copier dans.
 * Créer un système de fichiers virtuels de démarrage (initramfs) dans.
 * Créer les liens symboliques dans.
 * Ajouter du contenu personnalisé dans le fichier initramfs comme les fichiers spécifiques à l’encryption, une image pour l'écran de chargement, des modules supplémentaires, et plus encore.
 * Compresser le fichier initramfs.
 * Configure le système d'amorçage pour démarrer sur le nouveau noyau et fichier initramfs.

Emerge
Procéder à l'installation du paquet genkernel :

Utilisation
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 passée avec la commande. Les options passées en ligne de commande prévalent sur celles définies dans. Le fichier de configuration est très bien documenté, cependant les options les plus courantes seront vues dans cet article. Le but est pour le lecteur d'être familier avec les invocations courantes de genkernel. Pour une information plus complète, se reporter 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 aident l'utilisateur à décider comment interagir avec le processus de configuration. L'utilisateur peut même décider si le fichier de configuration sera sauvegardé. Les options suivantes sont les options de configuration de premier ordre :


 * Pointe vers le fichier de configuration de Genkernel à utiliser (par défaut sur ).
 * Pointe vers le fichier de configuration de Genkernel à utiliser (par défaut sur ).


 * Active (ou désactive) la commande (qui invoque un menu de configuration interactif) avant de compiler le noyau.
 * Active (ou désactive) la commande (qui invoque un menu de configuration interactif) avant de compiler le noyau.


 * Propose un outil de configuration du noyau qui dépend des librairies GTK+. L'avantage de cette option et que la plupart des utilisateurs trouvent plus facile et plus claire la configuration du noyau en utilisant cet outil, vu qu'il dépend du système de fenêtres X. L'inconvénient de cette option est que le système de fenêtres X est requis pour l'utiliser, et ne marchera donc pas en ligne de commande.
 * Propose un outil de configuration du noyau qui dépend des librairies GTK+. L'avantage de cette option et que la plupart des utilisateurs trouvent plus facile et plus claire la configuration du noyau en utilisant cet outil, vu qu'il dépend du système de fenêtres X. L'inconvénient de cette option est que le système de fenêtres X est requis pour l'utiliser, et ne marchera donc pas en ligne de commande.


 * Propose un outil de configuration du noyau qui dépend des librairies Qt. L'avantage de cette option et que la plupart des utilisateurs trouvent plus facile et plus claire la configuration du noyau en utilisant cet outil, vu qu'il dépend du système de fenêtres X. L'inconvénient de cette option est que le système de fenêtres X est requis pour l'utiliser, et ne marchera donc pas en ligne de commande.
 * Propose un outil de configuration du noyau qui dépend des librairies Qt. L'avantage de cette option et que la plupart des utilisateurs trouvent plus facile et plus claire la configuration du noyau en utilisant cet outil, vu qu'il dépend du système de fenêtres X. L'inconvénient de cette option est que le système de fenêtres X est requis pour l'utiliser, et ne marchera donc pas en ligne de commande.


 * Enregistrer [ou non] la configuration du noyau dans un fichier dans le répertoire pour un usage ultérieur.
 * Enregistrer [ou non] la configuration du noyau dans un fichier dans le répertoire pour un usage ultérieur.


 * Permet la modification du nom du noyau et des images initrd dans le répertoire, de façon à ce que les images générées soient pas et.
 * Permet la modification du nom du noyau et des images initrd dans le répertoire, de façon à ce que les images générées soient pas et.

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.


 * Active (ou désactive) le support pour Fbsplash (framebuffer splash) dans l'image initrd générée par genkernerl. Pour outrepasser le thème par défaut utilisé par fbsplash, utilisez  (où   est le nom d'un des répertoires dans ).
 * Active (ou désactive) le support pour Fbsplash (framebuffer splash) dans l'image initrd générée par genkernerl. Pour outrepasser le thème par défaut utilisé par fbsplash, utilisez  (où   est le nom d'un des répertoires dans ).


 * Cette option permet de sélectionner les résolutions qui seront supportées par l'écran de chargement dans le fichier initrd lors du démarrage du système. C'est utile pour deux raisons. D'abord, pour permettre de ne sélectionner seulement que les résolutions pertinentes au système. Deuxièmement, pour éviter les augmentations inutiles de l'espace disque requis par le fichier initrd (vu que le fichier initrd n'a pas besoin de prendre un compte les résolutions qui ne sont pas supportées par le système). Cependant, il est préférable d'omettre l'option si le noyau est compilé pour une image CD ; cela permet de supporter toutes les résolutions possibles pour l'écran de chargement.
 * Cette option permet de sélectionner les résolutions qui seront supportées par l'écran de chargement dans le fichier initrd lors du démarrage du système. C'est utile pour deux raisons. D'abord, pour permettre de ne sélectionner seulement que les résolutions pertinentes au système. Deuxièmement, pour éviter les augmentations inutiles de l'espace disque requis par le fichier initrd (vu que le fichier initrd n'a pas besoin de prendre un compte les résolutions qui ne sont pas supportées par le système). Cependant, il est préférable d'omettre l'option si le noyau est compilé pour une image CD ; cela permet de supporter toutes les résolutions possibles pour l'écran de chargement.


 * Force la sélection d'un dispositif de clavier lors du démarrage.
 * Force la sélection d'un dispositif de clavier lors du démarrage.


 * Inclut le support pour le stockage via Logical Volume Management (LVM2) depuis les fichiers binaires statiques, si disponibles sur le système. Les fichiers LVM2 binaires nécessaires seront compilés s'ils ne sont pas disponibles. Être sur d'avoir le paquet installé sur le système  avant d'activer cette option, puis se reporter à l'article sur LVM du wiki Gentoo.
 * Inclut le support pour le stockage via Logical Volume Management (LVM2) depuis les fichiers binaires statiques, si disponibles sur le système. Les fichiers LVM2 binaires nécessaires seront compilés s'ils ne sont pas disponibles. Être sur d'avoir le paquet installé sur le système  avant d'activer cette option, puis se reporter à l'article sur LVM du wiki Gentoo.


 * Inclut le support pour DMRAID ; l'utilitaire qui crée des mappages RAID à l'aide du sous-système mappeur de périphérique du noyau. DMRAID découvre, active, désactive et affiche les propriétés des jeux logiciels RAID (ATARAID, par exemple) et partitions DOS.
 * Inclut le support pour DMRAID ; l'utilitaire qui crée des mappages RAID à l'aide du sous-système mappeur de périphérique du noyau. DMRAID découvre, active, désactive et affiche les propriétés des jeux logiciels RAID (ATARAID, par exemple) et partitions DOS.


 * Inclut le support pour Linux Unified Key Setup ou LUKS. Cela permettra d'utiliser une partition encryptée comme système de fichiers racine. Dans le système d'amorçage, mettre cette partition comme valeur de  (et   doit désigner la partition décryptée créée par LUKS).
 * Inclut le support pour Linux Unified Key Setup ou LUKS. Cela permettra d'utiliser une partition encryptée comme système de fichiers racine. Dans le système d'amorçage, mettre cette partition comme valeur de  (et   doit désigner la partition décryptée créée par LUKS).


 * Ajoute le support pour les labels et identifiants universels uniques (UUID) à l'image initrd.
 * Ajoute le support pour les labels et identifiants universels uniques (UUID) à l'image initrd.


 * Ajoute le support pour iSCSI à l'image initrd.
 * Ajoute le support pour iSCSI à l'image initrd.


 * Ajoute le support pour Multipath à l'image initrd.
 * Ajoute le support pour Multipath à l'image initrd.


 * Spécifie un fichier linuxrc créé par l'utilisateur — un script initialisé pendant le démarrage du noyau, avant l'actuel processus de démarrage. Un script linuxrc par défaut peut être trouvé dans le répertoire . Ce script permet de démarrer dans un petit noyau modulaire; il essaye de ne charger que le minimum des pilotes nécessaires (en tant de modules) au système.
 * Spécifie un fichier linuxrc créé par l'utilisateur — un script initialisé pendant le démarrage du noyau, avant l'actuel processus de démarrage. Un script linuxrc par défaut peut être trouvé dans le répertoire . Ce script permet de démarrer dans un petit noyau modulaire; il essaye de ne charger que le minimum des pilotes nécessaires (en tant de modules) au système.


 * Modifie l'emplacement par défaut du cache utilisé lors de la compilation du noyau.
 * Modifie l'emplacement par défaut du cache utilisé lors de la compilation du noyau.


 * Spécifie l'emplacement du répertoire temporaire utilisé par genkernel lors de la compilation du noyau.
 * Spécifie l'emplacement du répertoire temporaire utilisé par genkernel lors de la compilation du noyau.


 * Inclut le support pour Unification File System (UFS) dans l'image initrd.
 * Inclut le support pour Unification File System (UFS) dans l'image initrd.


 * Détecte si le répertoire doit être monté sur une partition séparée. Il regardera dans le script  pour les instructions sur comment monter la partition boot sur un système de fichiers (si nécessaire).
 * Détecte si le répertoire doit être monté sur une partition séparée. Il regardera dans le script  pour les instructions sur comment monter la partition boot sur un système de fichiers (si nécessaire).

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.


 * Spécifie le compilateur utilisé lors du processus de compilation du noyau.
 * Spécifie le compilateur utilisé lors du processus de compilation du noyau.


 * Spécifie l'éditeur de liens utilisé lors du processus de compilation du noyau.
 * Spécifie l'éditeur de liens utilisé lors du processus de compilation du noyau.


 * Spécifie l'assembleur utilisé lors du processus de compilation du noyau.
 * Spécifie l'assembleur utilisé lors du processus de compilation du noyau.


 * Spécifie une alternative à l'utilitaire GNU make utilisé lors du processus de compilation du noyau.
 * Spécifie une alternative à l'utilitaire GNU make utilisé lors du processus de compilation du noyau.


 * Spécifie le compilateur utilisé lors du processus de la compilation des utilitaires de support.
 * Spécifie le compilateur utilisé lors du processus de la compilation des utilitaires de support.


 * Spécifie l'éditeur de liens utilisé lors du processus de la compilation des utilitaires de support.
 * Spécifie l'éditeur de liens utilisé lors du processus de la compilation des utilitaires de support.


 * Spécifie l'assembleur utilisé lors du processus de la compilation des utilitaires de support.
 * Spécifie l'assembleur utilisé lors du processus de la compilation des utilitaires de support.


 * Spécifie une alternative à l'utilitaire GNU make utilisé lors de la compilation des utilitaires de support.
 * Spécifie une alternative à l'utilitaire GNU make utilisé lors de la compilation des utilitaires de support.


 * Spécifie le nombre de threads simultanés que l'utilitaire make peut mettre en œuvre alors que le noyau (et les utilitaires) sont compilés. La variable  est un nombre à choisir librement, bien que les valeurs les plus courantes soient obtenues en ajoutant un (1) au nombre de cœurs utilisés par le système ou simplement en utilisant le nombre de cœurs du système. Ainsi, pour un système avec un seul cœur, les valeurs d'option les plus courantes sont   ou   ; Un système à deux cœurs utilise très probablement les options   ou , etc. (Un système avec un processeur prenant en charge la technologie Hyper-Threading ™ (HT) peut être supposé avoir deux cœurs, à condition que le support Symmetric Multi-Processing (SMP) soit activé dans le noyau.)
 * Spécifie le nombre de threads simultanés que l'utilitaire make peut mettre en œuvre alors que le noyau (et les utilitaires) sont compilés. La variable  est un nombre à choisir librement, bien que les valeurs les plus courantes soient obtenues en ajoutant un (1) au nombre de cœurs utilisés par le système ou simplement en utilisant le nombre de cœurs du système. Ainsi, pour un système avec un seul cœur, les valeurs d'option les plus courantes sont   ou   ; Un système à deux cœurs utilise très probablement les options   ou , etc. (Un système avec un processeur prenant en charge la technologie Hyper-Threading ™ (HT) peut être supposé avoir deux cœurs, à condition que le support Symmetric Multi-Processing (SMP) soit activé dans le noyau.)

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


 * Spécifie un emplacement alternatif du noyau plutôt que l'emplacement par défaut.
 * Spécifie un emplacement alternatif du noyau plutôt que l'emplacement par défaut.


 * Spécifie une configuration alternative du noyau à utiliser plutôt que le fichier par défaut.
 * Spécifie une configuration alternative du noyau à utiliser plutôt que le fichier par défaut.


 * Spécifie un préfixe pour le répertoire dans lequel les modules du noyau seront installés (le chemin par défaut est le répertoire .)
 * Spécifie un préfixe pour le répertoire dans lequel les modules du noyau seront installés (le chemin par défaut est le répertoire .)


 * Active (ou désactive) la commande avant la compilation du noyau. La commande  supprime tous les fichiers objets et les dépendances de l'arbre source du noyau.
 * Active (ou désactive) la commande avant la compilation du noyau. La commande  supprime tous les fichiers objets et les dépendances de l'arbre source du noyau.


 * Active (désactive) la commande avant la compilation du noyau. Comme la commande  listée ci-dessus,  supprime tous les fichiers objets et les dépendances de l'arbre source du noyau. Cependant, les fichiers de configuration précedents (dans  ou ) seront aussi supprimés de l'arbde source du noyau. Si la disparition du fichier de configuration du noyau  n'est pas souhaitée, désactiver cette option.
 * Active (désactive) la commande avant la compilation du noyau. Comme la commande  listée ci-dessus,  supprime tous les fichiers objets et les dépendances de l'arbre source du noyau. Cependant, les fichiers de configuration précedents (dans  ou ) seront aussi supprimés de l'arbde source du noyau. Si la disparition du fichier de configuration du noyau  n'est pas souhaitée, désactiver cette option.


 * Exécute la commande, qui essaye de collecter des informations pour la configuration du noyau en fonction de l'architecture du système depuis un script générique dans . C'est un processus non-interactif ; aucune entrée utilisateur n'est demandée. Aussi, si l'option est utilisée conjointement avec l'option  , cette dernière est annulée, résultant en l'activation de l'option.
 * Exécute la commande, qui essaye de collecter des informations pour la configuration du noyau en fonction de l'architecture du système depuis un script générique dans . C'est un processus non-interactif ; aucune entrée utilisateur n'est demandée. Aussi, si l'option est utilisée conjointement avec l'option  , cette dernière est annulée, résultant en l'activation de l'option.


 * Appelle paramètres spécifiés (, dans ce cas) après que le noyau et les modules aient été compilés, mais avant l'installation de l'image initrd. Cela peut être utile quand des modules externes sont installés dans l'image initrd, permettant d'installer les items nécessaires avant de redéfinir une groupe de modules genkernel.
 * Appelle paramètres spécifiés (, dans ce cas) après que le noyau et les modules aient été compilés, mais avant l'installation de l'image initrd. Cela peut être utile quand des modules externes sont installés dans l'image initrd, permettant d'installer les items nécessaires avant de redéfinir une groupe de modules genkernel.


 * Active (ou désactive) la commande, qui installe la nouvelle image du noyau, le fichier de configuration, l'image initrd et la carte du système sur la partition boot. Chaque module compilé sera également installé. Par défaut, genkernel essaiera de monter si présent sur une partition séparée avant d'exécuter la commande.
 * Active (ou désactive) la commande, qui installe la nouvelle image du noyau, le fichier de configuration, l'image initrd et la carte du système sur la partition boot. Chaque module compilé sera également installé. Par défaut, genkernel essaiera de monter si présent sur une partition séparée avant d'exécuter la commande.


 * Évite de copier les modules dans l'image initrd créée par genkernel. Cette option est une exception à la règle sur l'utilisation du préfixe   ; l'oubli de ce préfixe créer une option de genkernel invalide.
 * Évite de copier les modules dans l'image initrd créée par genkernel. Cette option est une exception à la règle sur l'utilisation du préfixe   ; l'oubli de ce préfixe créer une option de genkernel invalide.


 * Copie tous les modules disponibles dans l'image initrd créée par genkernel.
 * Copie tous les modules disponibles dans l'image initrd créée par genkernel.


 * Créé l'image initrd, avant l'image du noyau (cette astuce ne s'applique actuellement qu'aux systèmes PPC Pegasos).
 * Créé l'image initrd, avant l'image du noyau (cette astuce 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.


 * Contrôle le niveau de verbosité de l'information donnée par genkernel. La variable  est un entier entre 0 et 5. Le niveau '0' représente une verbosité minimale, alors que '5' donne autant d'information que possible à propos de l'activité de genkernel durant le processus de compilation du noyau.
 * Contrôle le niveau de verbosité de l'information donnée par genkernel. La variable  est un entier entre 0 et 5. Le niveau '0' représente une verbosité minimale, alors que '5' donne autant d'information que possible à propos de l'activité de genkernel durant le processus de compilation du noyau.


 * Ignore la valeur fixée par l'option  (ci-dessus) et envoie toutes les informations de débogage produites par genkernel dans fichier spécifié. Le fichier par défaut est.
 * Ignore la valeur fixée par l'option  (ci-dessus) et envoie toutes les informations de débogage produites par genkernel dans fichier spécifié. Le fichier par défaut est.


 * Active (ou désactive) la sortie colorée des informations de débogage (générées par genkernel) en utilisant des séquences d'échappement.
 * Active (ou désactive) la sortie colorée des informations de débogage (générées par genkernel) en utilisant des séquences d'échappement.


 * Active (ou désactive) le nettoyage complet d'après exécution pour un débogage plus facile.
 * Active (ou désactive) le nettoyage complet d'après exécution pour un débogage plus facile.

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

Démarrer
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 en tampon de trames (framebuffer) qui devra être installé à la main. Dans la phase préparatoire de compilation, genkernel n'effacera pas les objets déjà compilés. Enfin, un menu de configuration sera affiché, permettant à l'utilisateur de choisir quels modules seront compilés.

Remplacer  par   pour qu'il installe automatiquement le nouveau noyau dans  et spécifier   pour qu'il crée les liens symboliques. En utilisant le paramètre -- , la partition  sera montée par genkernel automatiquement, si nécessaire.

Changer le noyau
La première chose à faire est d'autoriser le lancement de dans le fichier  :

Gestion des fichiers
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
Après une commande ,, chaque fois que de nouvelles sources sont disponibles, un nouveau répertoire 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 répertoire pourrait ressembler à ceci :

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


 * Si l'option  de la variable USE est définie 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  n'est pas définie, l'utilisateur peut changer la destination du lien symbolique en utilisant la commande  suivie de la commande.

genkernel utilisera toujours (exclusivement) les sources pointées par le lien symbolique.

Fichiers de configuration du noyau
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   par l'architecture du système,   par la version des sources utilisées et   par le numéro de divulgation des sources.

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

Si c'est la première fois que genkernel est exécuté avec les nouvelles sources du noyau, 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 l'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 la prochaine exécution de.

Installer le noyau et le disque virtuel de démarrage dans le dossier
Spécifier l'option  lors de l'invocation de genkernel, demandera à genkernel d'installer les images du noyau et du système de fichiers virtuel de démarrage (initramfs) dans le dossier. Afin d'exécuter  d'une manière appropriée, définir ce qui suit dans le fichier  :


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


 * Le second paramètre dit à 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  à son nom. Un lien symbolique qui pointe sur lui  est automatiquement créé.
 * 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 qui pointe sur le nouveau noyau est automatiquement créé.

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

Configurer le programme d'amorçage
Les liens symboliques présentées plus haut peuvent être utilisés pour configurer le programme d'amorçage, 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 nouveau noyau et au nouveau système de fichiers virtuel initrd produit par genkernel de fonctionner correctement, il faut fournir un minimum d'informations dans le fichier de configuration du programme d'amorçage :


 * Ajouter  aux paramètres du noyau passés à l'image du noyau, où  pointe sur le partition root (  est le numéro de la partition si une partition existe.).
 * Si un écran de chargement est utilisé, ajouter une ligne pour le mode approprié tel que  aux paramètres passés au noyau et ajouter aussi   ou   en fonction du niveau de verbosité voulu tout au long du processus de démarrage.
 * Ajouter l'information sur l'image initrd comme requis par le système d'amorçage. Consulter le chapitre sur la Configuration du Système d'amorçage du manuel Gentoo pour plus de détails sur comment rendre le système d'amorçage au courant de l'existence du fichier initrd.

Voici à quoi le fichier pourrait ressembler.

Préserver les 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 est 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, commencer par effacer la nouvelle image du noyau et supprimer le suffixe 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çable. Tenir le même raisonnement pour initramfs.

Utiliser la configuration précédente du noyau tout en changeant les sources
La configuration précédente peut être utilisée via la variable make menuconfig dans le fichier comme ci-après :

Checking that initramfs includes necessary utilites before booting
Before booting the system, it might be wise checking that initramfs includes necessary utilities. For example, a missing cryptsetup will produce a kernel panic when booting with LUKS. This post uses the following procedure to check that initramfs includes cryptsetup:

Depuis un CD-ROM d'installation
L'outil peut fabriquer des images de noyau et de disque virtuel initial (initrd) qui permettent de démarrer sur le réseau (netboot). Avec un peu de chance, il est possible de 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 un initrd qui prennent en charge le démarrage par le réseau
Pour activer le support du démarrage par le réseau, activer les options suivantes lors de la configuration du noyau :

Tout d'abord, l'image du noyau doit contenir les pilotes de la carte réseau du système. 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.

Ensuite, il est suggéré 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 — ce qui est très important pour un démarrage via ethernet.

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

De plus, 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. Pour activer SquashFS, appliquer les correctifs nécessaires ou bien installer les gentoo-sources.

Une fois que le processus de compilation est terminé, créer une archive compressée (.tar.gz) qui contient les modules du noyau. Cette étape n'est nécessaire que si la version du 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 la méthode de démarrage par le réseau, l'une des étapes suivantes doit être exécutée :

Pour créer une image etherboot :

Pour créer une image TFTP OpenBoot/SPARC64 :

Le fichier est l'image à démarrer.

Enfin, copier ce noyau sur le serveur TFTP. La manière de procéder dépend complètement de l'architecture et dépasse les limites de ce guide. Consulter la documentation spécifique de la plate-forme utilisée.

Configuration du NFS
Pour mettre en place un partage NFS qui contient le CD-ROM d'installation, utiliser un périphérique de bouclage (loop device) pour y monter l'image ISO et copier 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 reste à faire est de copier l'archive dans le répertoire.

En supposant que soit un partage NFS :

Copier dans

Configuration du DHCP
Les images netboot demanderont une adresse IP et un chemin NFS au serveur DHCP ainsi qu'une option. 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émarrer. La ligne de commande du noyau a été spécifiée lors de la construction de l'image. Avec Sparc64, appuyer sur + à l'invite de démarrage puis entrer :

Pour PXE, configurer pxelinux (qui fait partie de syslinux), puis créer un fichier qui contient ces lignes :

Introduction
Si un disque virtuel initial (initramfs) a été installé avec genkernel, alors regarder les options diverses et variées de boot que qui peuvent (ou doivent) être définies dans la configuration du système d'amorçage. Les plus courantes sont citées ici pour référence.

Chargement de LVM ou de software-RAID
Si le système utilise LVM ou RAID logiciel, le disque virtuel initial (initramfs) a du être construit en utilisant les options  et. Néanmoins, ne 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écupération root.

La compilation a échouée : Kernel not found
Cet échec peut être rencontré quand l'utilisateur essaye de compiler un noyau pour une architecture avec un fichier de configuration noyau qui cible une architecture différente. Cela peut être aussi simple qu'une machine tournant sur un noyau et qui essaye de compiler pour une machine cible sous.

Cela peut être rencontré quand l'utilisateur démarre depuis un LiveCD x86_64 sur un système capable d'opérer en 64 bits, alors que le système cible à installer ou réparer est en 32 bits. Après que le processus de compilation ne démarre, essaiera automatiquement de détecter l'architecture pour le système cible en fonction de celle du noyau actuel. Si le noyau actuel est en 64 bits, alors, à moins que spécifié, assumera qu'il doit chercher pour un noyau 64 bits.

Supposer que le fichier du noyau a désactivé le support pour x64. La commande s'exécutera et le noyau résultant sera placé dans le répertoire  associé. Quand va pour installer (déplacer et renommer) le noyau, il ne pourra pas le trouver car il s'attendait à un noyau 64 bits.

La solution est de mettre l'option de   à, dans ce cas, l'architecture. La commande final ressemblera à ceci :

Pour outrepasser le choix d'architecture de façon permanente, modifier la variable ARCH_OVERRIDE dans le fichier.

Les modules externes (tels que xtables_addons) doivent être recompilés manuellement avec un nouveau noyau
Genkernel peut recompiler des modules externes après la compilation du noyau ; modifier pour inclure cette ligne :

Voir aussi

 * Configuration du noyau manuelle - Pour quand il est nécessaire de faire les choses manuellement.
 * Dracut - Un autre outil de création des fichiers initramfs disponible dans Gentoo.