Section courante

A propos

Section administrative du site

Clefs de configuration de GRUB

Les clefs (KEY) valides dans /etc/default/grub sont les suivantes :

Clef Description
'GRUB_DEFAULT' L'entrée de menu par défaut. Il peut s'agir d'un nombre, auquel cas il identifie la énième entrée du menu généré (comptée à partir de zéro), du titre d'une entrée de menu ou de la chaîne spéciale «saved». L'utilisation de l'identifiant peut être utile si vous souhaitez définir une entrée de menu comme entrée par défaut, même si elle est précédée d'un nombre variable d'entrées.

Par exemple, si vous avez :
menuentry 'Exemple de distribution GNU/Linux' --class gnu-linux --id example-gnu-linux {
    ...
}

alors vous pouvez en faire la valeur par défaut en utilisant :
GRUB_DEFAULT=example-gnu-linux

L'utilisation du titre d'entrée était déjà documentée. Bien que cela fonctionne toujours, ce n'est pas recommandé, car les titres contiennent souvent des noms de périphériques instables et peuvent être traduits.

Si vous définissez ce paramètre sur «saved», l'entrée de menu par défaut sera celle enregistrée par « GRUB_SAVEDEFAULT » ou grub-set-default. Cela dépend du bloc d'environnement, qui peut ne pas être disponible dans toutes les situations (voir Bloc d'environnement).

La valeur par défaut est « 0 ».
'GRUB_SAVEDEFAULT' Si cette option est définie sur «true», lorsqu'une entrée est sélectionnée, elle est enregistrée comme nouvelle entrée par défaut pour les futures exécutions de GRUB. Cette option n'est utile que si « GRUB_DEFAULT=saved » ; il s'agit d'une option distincte, car « GRUB_DEFAULT=saved » est utile sans cette option, en conjonction avec grub-set-default. Non définie par défaut. Cette option repose sur le bloc d'environnement, qui peut ne pas être disponible dans toutes les situations.
'GRUB_TIMEOUT' Démarre l'entrée par défaut après l'affichage du menu, sauf si une touche est enfoncée. La valeur par défaut est « 5 ». Définissez « 0 » pour démarrer immédiatement sans afficher le menu, ou « -1 » pour attendre indéfiniment.

Si «GRUB_TIMEOUT_STYLE» est défini sur «countdown» ou «hidden», le délai d'attente est compté avant l'affichage du menu.
'GRUB_TIMEOUT_STYLE' Si cette option est désactivée ou définie sur « menu », GRUB affiche le menu et attend l'expiration du délai défini par «GRUB_TIMEOUT» avant de démarrer l'entrée par défaut. Appuyer sur une touche interrompt ce délai.
Si cette option est définie sur « compte à rebours » ou « masqué », GRUB attend l'expiration du délai défini par « GRUB_TIMEOUT » avant d'afficher le menu. Si vous appuyez sur Esc ou F4, ou si vous maintenez la touche Shift enfoncée pendant ce temps, le menu s'affiche et attend une saisie. Si vous appuyez sur une touche de raccourci associée à une entrée de menu, l'entrée correspondante est immédiatement démarrée. Si le délai expire avant l'expiration de l'une de ces deux touches, l'entrée par défaut est démarrée. Dans le cas du « compte à rebours », une ligne indique le temps restant.
'GRUB_DEFAULT_BUTTON'
'GRUB_TIMEOUT_BUTTON'
'GRUB_TIMEOUT_STYLE_BUTTON'
'GRUB_BUTTON_CMOS_ADDRESS'		 Variantes des variables correspondantes sans le suffixe « _BUTTON », utilisées pour prendre en charge les boutons d'alimentation spécifiques au fournisseur. Voir les touches d'alimentation du fournisseur.
'GRUB_DISTRIBUTOR' Défini par les distributeurs de GRUB sur leur nom d'identification. Ceci permet de générer des titres d'entrées de menu plus informatifs.
'GRUB_TERMINAL_INPUT' Sélectionne le périphérique d'entrée du terminal. Vous pouvez sélectionner plusieurs périphériques ici, séparés par des espaces. Les noms d'entrée de terminal valides dépendent de la plateforme, mais peuvent inclure « console » (console native de la plateforme), «serial» (terminal série), « serial_<port> » (terminal série avec sélection de port explicite), « at_keyboard » (clavier AT PC) ou « usb_keyboard » (clavier USB utilisant le protocole de démarrage HID, lorsque le micrologiciel ne le gère pas). Par défaut, l'entrée de terminal native de la plateforme est utilisée.
'GRUB_TERMINAL_OUTPUT' Sélectionnez le périphérique de sortie du terminal. Vous pouvez sélectionner plusieurs périphériques ici, en les séparant par des espaces. Les noms de sortie de terminal valides dépendent de la plateforme, mais peuvent inclure « console » (console native de la plateforme), «serial» (terminal série), « serial_<port>» (terminal série avec sélection de port explicite), «gfxterm» (sortie en mode graphique), «vga_text» (sortie texte VGA), «mda_text» (sortie texte MDA), «morse» (codage Morse utilisant le bip système) ou «spkmodem» (protocole de données simple utilisant le haut-parleur système). «spkmodem» est utile lorsqu'aucun port série n'est disponible. Connectez la sortie du système émetteur (où GRUB est exécuté) à l'entrée ligne du système récepteur (généralement la machine du développeur). Sur le système récepteur, compilez «spkmodem-recv» depuis «util/spkmodem-recv.c» et exécutez :

parecord --channels=1 --rate=48000 --format=s16le | ./spkmodem-recv

La valeur par défaut est d'utiliser la sortie du terminal natif de la plateforme.
'GRUB_TERMINAL' Si cette option est définie, elle remplace « GRUB_TERMINAL_INPUT » et « GRUB_TERMINAL_OUTPUT » par la même valeur.
'GRUB_SERIAL_COMMAND' Commande permettant de configurer le port série lors de l'utilisation de la console série. Voir «série». La valeur par défaut est «série».
'GRUB_CMDLINE_LINUX' Paramètres de ligne de commande à ajouter aux entrées de menu pour le noyau Linux.
'GRUB_CMDLINE_LINUX_DEFAULT' Sauf si «GRUB_DISABLE_RECOVERY» est défini sur «true», deux entrées de menu sont générées pour chaque noyau Linux : une entrée par défaut et une entrée pour le mode de récupération. Cette option répertorie les paramètres de ligne de commande à ajouter uniquement à l'entrée de menu par défaut, après ceux listés dans «GRUB_CMDLINE_LINUX».
'GRUB_CMDLINE_LINUX_RECOVERY' Sauf si « GRUB_DISABLE_RECOVERY » est défini sur « true », deux entrées de menu sont générées pour chaque noyau Linux : une entrée par défaut et une entrée pour le mode de récupération. Cette option liste les arguments de ligne de commande à ajouter uniquement à l'entrée du menu de récupération, avant ceux listés dans « GRUB_CMDLINE_LINUX ». La valeur par défaut est «single».
'GRUB_CMDLINE_NETBSD'
'GRUB_CMDLINE_NETBSD_DEFAULT'		 Comme «GRUB_CMDLINE_LINUX» et «GRUB_CMDLINE_LINUX_DEFAULT», mais pour NetBSD.
'GRUB_CMDLINE_GNUMACH' Comme «GRUB_CMDLINE_LINUX», mais pour GNU Mach.
'GRUB_CMDLINE_XEN'
'GRUB_CMDLINE_XEN_DEFAULT'		 Les valeurs de ces options sont transmises aux entrées de menu Xen de l'hyperviseur Xen, pour toutes les entrées respectivement normales.
'GRUB_CMDLINE_LINUX_XEN_REPLACE'
'GRUB_CMDLINE_LINUX_XEN_REPLACE_DEFAULT'		 Les valeurs de ces options remplacent les valeurs de « GRUB_CMDLINE_LINUX » et « GRUB_CMDLINE_LINUX_DEFAULT » pour les entrées de menu Linux et Xen.
'GRUB_TOP_LEVEL'
'GRUB_TOP_LEVEL_XEN'		 Cette option doit être un chemin absolu vers une image du noyau. Si elle est fournie, l'image spécifiée sera l'entrée de niveau supérieur si elle est détectée lors de l'analyse.
'GRUB_TOP_LEVEL_OS_PROBER' Cette option doit être une ligne de sortie d'os-prober. Si «GRUB_TOP_LEVEL» est fournie, l'image spécifiée sera l'entrée de niveau supérieur si elle est détectée lors de l'analyse.
'GRUB_EARLY_INITRD_LINUX_CUSTOM'
'GRUB_EARLY_INITRD_LINUX_STOCK'		 Liste des premières images initrd, séparées par des espaces, à charger depuis «/boot». Ceci permet de charger des éléments tels que le microcode du processeur, le firmware, les tables ACPI, les clés de chiffrement, etc. Ces premières images seront chargées dans l'ordre déclaré, et toutes seront chargées avant l'image initrd fonctionnelle.

« GRUB_EARLY_INITRD_LINUX_STOCK » permet à votre distribution de déclarer les images fournies par la distribution. Il ne faut pas le modifier sans en connaître les conséquences. Elles seront chargées en premier.

« GRUB_EARLY_INITRD_LINUX_CUSTOM » est destiné à vos images personnalisées.

Les images d'entreposage par défaut sont les suivantes, mais elles peuvent être remplacées par votre distribution :
intel-uc.img intel-ucode.img amd-uc.img amd-ucode.img early_ucode.cpio microcode.cpio
'GRUB_DISABLE_LINUX_UUID' Normalement, grub-mkconfig génère des entrées de menu utilisant des identifiants uniques universels (UUID) pour identifier le système de fichiers racine du noyau Linux, à l'aide du paramètre noyau « root=UUID=... ». Cette méthode est généralement plus fiable, mais peut parfois s'avérer inappropriée. Pour désactiver l'utilisation des UUID, définissez cette option sur « true ».
'GRUB_DISABLE_LINUX_PARTUUID' Si grub-mkconfig ne parvient pas à identifier le système de fichiers racine via son identifiant unique universel (UUID), il peut utiliser l'UUID de la partition contenant le système de fichiers pour identifier le système de fichiers racine auprès du noyau Linux via le paramètre noyau « root=PARTUUID=... ». Cette méthode n'est pas aussi fiable que l'utilisation de l'UUID du système de fichiers, mais elle est plus fiable que l'utilisation des noms de périphériques Linux. Lorsque « GRUB_DISABLE_LINUX_PARTUUID » est défini sur « false », la version du noyau Linux doit être 2.6.37 (3.10 pour les systèmes utilisant le schéma de partitionnement MSDOS) ou une version ultérieure. Cette option est définie par défaut sur « true ». Pour activer l'utilisation des UUID de partition, définissez cette option sur « false ».
'GRUB_DISABLE_RECOVERY' Si cette option est définie sur «true», désactivez la génération des entrées de menu du mode de récupération.
'GRUB_DISABLE_UUID' Normalement, grub-mkconfig génère des entrées de menu utilisant des identifiants uniques universels (UUID) pour identifier les différents systèmes de fichiers et rechercher des fichiers. Cette méthode est généralement plus fiable, mais peut parfois être inappropriée. Pour désactiver l'utilisation des UUID, définissez cette option sur « true ». Cette configuration active également les options « GRUB_DISABLE_LINUX_UUID » et « GRUB_DISABLE_LINUX_PARTUUID », sauf si elles ont été explicitement définies sur « false ».
'GRUB_VIDEO_BACKEND' Si la prise en charge de la vidéo graphique est requise, soit parce que le terminal graphique «gfxterm» est utilisé, soit parce que «GRUB_GFXPAYLOAD_LINUX» est défini, grub-mkconfig chargera normalement tous les pilotes vidéo GRUB disponibles et utilisera celui qui convient le mieux à votre matériel. Si vous devez contourner cette option, vous pouvez la définir. Après l'exécution de grub-install, les pilotes vidéo disponibles sont répertoriés dans /boot/grub/video.lst.
'GRUB_GFXMODE' Définissez la résolution utilisée sur le terminal graphique « gfxterm ». Notez que vous ne pouvez utiliser que les modes pris en charge par votre carte graphique via les extensions BIOS VESA (VBE). Par exemple, les résolutions natives des écrans LCD peuvent ne pas être disponibles. La valeur par défaut est « auto », qui tente de sélectionner une résolution préférée. Voir gfxmode.
'GRUB_BACKGROUND' Définissez une image d'arrière-plan à utiliser avec le terminal graphique « gfxterm ». La valeur de cette option doit être un fichier lisible par GRUB au démarrage, et doit se terminer par .png, .tga, .jpg ou .jpeg. L'image sera redimensionnée si nécessaire pour s'adapter à l'écran. La hauteur et la largeur de l'image seront limitées artificiellement à 16 384.
'GRUB_THEME' Définissez un thème à utiliser avec le terminal graphique « gfxterm ».
'GRUB_GFXPAYLOAD_LINUX' Choisissez «text» pour forcer le noyau Linux à démarrer en mode texte normal, «keep» pour conserver le mode graphique défini via « GRUB_GFXMODE », « widthxheight » [« xdepth »] pour définir un mode graphique particulier, ou une séquence de ces options séparées par des virgules ou des points-virgules pour tester plusieurs modes à la suite. Voir gfxpayload. En fonction de votre noyau, de votre distribution, de votre carte graphique et de la phase lunaire, notez que l'utilisation de cette option peut entraîner divers problèmes d'affichage sous GNU/Linux, notamment au début de la séquence de démarrage. En cas de problème, choisissez «text» et GRUB indiquera à Linux de démarrer en mode texte normal.
'GRUB_DISABLE_OS_PROBER' La commande grub-mkconfig permet d'utiliser le programme externe os-prober pour détecter les autres systèmes d'exploitation installés sur la même machine et générer les entrées de menu appropriées. Cette option est désactivée par défaut, car l'exécution automatique et silencieuse d'os-prober et la création d'entrées de démarrage basées sur ces données constituent un vecteur d'attaque potentiel. Définissez cette option sur « false » pour activer cette fonctionnalité dans la commande grub-mkconfig.
'GRUB_OS_PROBER_SKIP_LIST' Liste des UUID FS séparés par des espaces des systèmes de fichiers à ignorer dans la sortie d'os-prober. Pour les chargeurs de chaîne eFI, la valeur est <UUID>@<FICHIER EFI>.
'GRUB_DISABLE_SUBMENU' Normalement, grub-mkconfig génère l'entrée de menu principal pour le noyau dont le numéro de version est le plus élevé et place tous les autres noyaux trouvés ou les entrées de menu alternatives pour le mode de récupération dans un sous-menu. Pour les entrées renvoyées par os-prober, la première entrée est placée au niveau principal et toutes les autres dans un sous-menu. Si cette option est définie sur « true », un menu simple avec toutes les entrées au niveau principal est généré. Modifier cette option nécessite de modifier les valeurs des variables d'environnement « GRUB_DEFAULT », « fallback » (voir fallback) et « default » (voir default), ainsi que l'entrée par défaut enregistrée avec grub-set-default et la valeur utilisée avec grub-reboot.
'GRUB_ENABLE_CRYPTODISK' Si la valeur est « y », grub-mkconfig et grub-install rechercheront les disques chiffrés et généreront les commandes supplémentaires nécessaires pour y accéder au démarrage. Notez que dans ce cas, le démarrage automatique est impossible, car GRUB attendra la phrase secrète pour déverrouiller le conteneur chiffré.
'GRUB_INIT_TUNE' Jouer un morceau sur le haut-parleur au démarrage de GRUB. Ceci est particulièrement utile pour les utilisateurs ne voyant pas l'écran. La valeur de cette option est transmise directement à l'option «play».
'GRUB_BADRAM' Si cette option est définie, GRUB émettra une commande badram pour filtrer les régions spécifiées de la RAM.
'GRUB_PRELOAD_MODULES' Cette option peut être définie sur une liste de noms de modules GRUB séparés par des espaces. Chaque module sera chargé le plus tôt possible, au début du fichier grub.cfg.

Les options suivantes sont toujours acceptées pour des raisons de compatibilité avec les configurations existantes, mais disposent de meilleurs remplacements :

Clef Description
'GRUB_HIDDEN_TIMEOUT' Attendez ce nombre de secondes avant d'afficher le menu. Si vous appuyez sur Esc ou F4, ou si vous maintenez la touche Maj enfoncée pendant ce temps, affichez le menu et attendez une saisie selon le délai « GRUB_TIMEOUT ». Si vous appuyez sur une touche de raccourci associée à une entrée de menu, démarrez immédiatement l'entrée correspondante. Si le délai expire avant l'un de ces événements, affichez le menu pendant le nombre de secondes spécifié dans « GRUB_TIMEOUT » avant de démarrer l'entrée par défaut. Si vous définissez « GRUB_HIDDEN_TIMEOUT », vous devez également définir « GRUB_TIMEOUT=0 » afin que le menu ne s'affiche que si vous appuyez sur Esc ou F4, ou si vous maintenez la touche Shift enfoncée. Cette option est désactivée par défaut et est déconseillée au profit des options moins complexes « GRUB_TIMEOUT_STYLE=countdown » ou « GRUB_TIMEOUT_STYLE=hidden ».
'GRUB_HIDDEN_TIMEOUT_QUIET' En conjonction avec « GRUB_HIDDEN_TIMEOUT », définissez cette option sur « true » pour supprimer le compte à rebours détaillé en attendant qu'une touche soit enfoncée avant l'affichage du menu. Cette option est désactivée par défaut et est déconseillée au profit de « GRUB_TIMEOUT_STYLE=countdown », moins déroutante.
'GRUB_HIDDEN_TIMEOUT_BUTTON' Variante de « GRUB_HIDDEN_TIMEOUT », utilisée pour prendre en charge les boutons d'alimentation spécifiques aux fournisseurs. Voir les touches d'alimentation des fournisseurs. Cette option est désactivée par défaut et est déconseillée au profit de « GRUB_TIMEOUT_STYLE=countdown » ou « GRUB_TIMEOUT_STYLE=hidden », moins déroutantes.

Pour une personnalisation plus détaillée de la sortie de grub-mkconfig, vous pouvez modifier directement les scripts dans /etc/grub.d. /etc/grub.d/40_custom est particulièrement utile pour ajouter des entrées de menu personnalisées entières ; saisissez simplement les entrées de menu que vous souhaitez ajouter à la fin de ce fichier, en vous assurant de laisser au moins les deux premières lignes intactes.



Dernière mise à jour : Mercredi, le 2 avril 2025