Console Grub - Principe

Mise à jour : Debian 10.6 Buster

Ce document décrit l'interface opérateur en ligne de commande de grub

Références :

• Manuel Grub2 (en anglais)

• Manuel Grub2 - Variables
  
• Manuel Grub2 - Commandes
  

Sommaire

1 - Interface opérateur

1.1 - Modes d'affichage

Grub dispose de trois modes d'affichage

• soit une interface plein écran dédiée à l'affichage, l'édition et la sélection des systèmes d'exploitation, ce mode est appelé ci-après Mode Menu.
  

• soit une interface en ligne de commande, ayant pour invite (prompt) "grub >" , ce mode est appelé ci-après Mode Normal. Dans ce mode, les commandes d'auto-complétude et l’historique de commande sont disponibles

• soit une interface en ligne de commande, ayant pour invite (prompt) "grub rescue", ce mode est appelé ci-après Mode Rescue. Les commandes d'auto-complétude et d’historique de commandes ne sont alors pas disponibles,
  

1.2 - Mode d'affichage au démarrage

Le mode d'affichage obtenu au démarrage est conditionné par la disponibilité

• du module grub "normal". Ce module est situé
  
• dans le répertoire /boot/grub/x86_64-efi/ (amorçage UEFI) ou /boot/grub/i386-pc/ (amorçage MBR/BIOS), dans le cas d'une installation standard avec répertoire boot situé dans la partition racine
• dans le le répertoire /grub/x86_64-efi/ (amorçage UEFI) ou /grub/i386-pc/ (amorçage MBR/BIOS), dans le cas d'une installation standard avec partition boot dédiée

• du fichier de configuration, grub.cfg. Ce fichier est situé
  
• dans le répertoire /boot/grub/ de la partition racine, dans le cas d'une installation standard avec répertoire boot situé dans une partition racine
• dans le répertoire /grub/ de la partition boot, dans le cas d'une installation standard avec partition boot dédié

Lorsque grub est lancé (amorçage du système)

• s'il est correctement installé, le module normal et le fichier de configuration grub.cfg sont disponibles et accessibles, le Mode Menu s'affiche
  
• si grub échoue à atteindre le fichier grub.cfg, soit qu'il n'existe pas, soit que le disque, la partition ou le répertoire supposés le contenir ne sont pas accessibles, mais qu'il réussit à charger le module "normal", le Mode Normal s'affiche
• si grub échoue à charger le module "normal", le Mode Rescue s'affiche

1.3 - Accès au Mode Normal

• Depuis le Mode Menu : touche c
• Depuis le Mode Menu en édition : touche F2
• Depuis le Mode Rescue :
  
• Définir les variables root et prefix de façon à ce qu'elles permettent l'accès aux modules Grub (voir Modules)
• Charger le module normal

grub rescue> insmod normal
grub rescue> normal

2 - Variables d'environnement

• Liste des variables d'environnement

grub> set

• Affichage de la valeur d'une variable

grub> echo $root
hd0,msdos1

• Création ou redéfinition d'une variable

• forme longue

grub> set pager=1      

• forme courte équivalente

grub> pager=1         

3 - Unités de stockage et partitions

3.1 - Syntaxe

• Les unités de stockage sont nommées (hd0), (hd1), etc, à partir de 0 ...
• Les partitions de l'unité (hdx) sont nommées
  
• dans le cas d'un partitionnement msdos (hdx,msdos1), (hdx, msdos2), ....
  
• dans le cas, d'un partitionnement gpt, (hdx,gpt1), (hdx,gpt2), ....
• La notation (hdx,y) est également acceptée dans la console grub, mais pas dans la console grub rescue

Dans les exemples ci-dessous, il faudra donc remplacer (hdx,msdosy) par (hdx,gpty) dans le cas d'un partitionnement gpt

3.2 - Liste

Utiliser la commande ls et la touche Entrée pour lister les unités de stockage et leurs partitions :

grub> ls (Utiliser la touche Entrée pour faire afficher la lige suivante)
(hd0) (hd0,msdos05) (hd0,msdos01)

Dans cet exemple, un disque hd0 avec deux partitions ont été trouvées.

3.3 - Informations détaillées

Pour connaître les numéros de partition, étiquettes, système de fichiers, date de modifications, identifiant UUID, ...

• Sur toutes les unités de stockage et leurs partitions :

grub> ls (hd (utiliser la touche TABULATION pour faire afficher la liste des unités de stockage et partitions)
.......

• Sur une unité de stockage ou sur une partition :

grub> ls (hd0)
Périphérique hd0 : Aucun système de fichiers connu détecté - Taille de secteur 512 o - Taille totale 8388608 Kio.
grub> ls (hd0,msdos1)
Partition hd0,msdos1 : Type de système de fichiers ext* - Dernière date de modification jeudi 29/10/2015 19:16:43, UUID 13b613fd-89f8-4b22-a530-2f352fdbd54b - La partition commence à 1024 Kio - Taille totale XXXXXXXX Kio

4 - Répertoires & Fichiers

4.1 - Syntaxe

Les répertoires et fichiers sont désignés par leur chemin par rapport à l'unité de stockage et la partition.

• La notation longue est :

(hdx,msdosy)/chemin/vers/le/fichier

• Il est possible d'omettre l'unité de stockage et la partition, en utilisant la notation implicite basée sur la variable d'environnement root
  

grub> set root=hdx,msdosy

• Les trois commandes suivantes sont alors équivalentes
  

grub> ls /<chemin/vers/le/fichier
grub> ls ($root)/<chemin/vers/le/fichier
grub> ls (hdx,msdosy)/<chemin/vers/le/fichier

4.2 - Navigation dans l'arborescence

• Liste des périphériques de stockage

grub> ls

• Liste des répertoires, fichiers et liens à partir de l'emplacement courant :
  

grub> ls / (utiliser Tab pour obtenir la ligne suivante)
lost+found/ etc/ media/ vmlinuz var/ usr/ lib/ boot/ (......) initrd.img

Dans cet exemple vmlinuz et initrd.img ont été trouvés à la racine de la partition (hd0, msdos1). Ce sont des liens vers les fichiers vmlinuz et initrd.gz, ce qui est le cas par défaut dans les installations Debian

• Changer de répertoire :
  

grub> cd boot

• Lister le contenu d'un fichier :
  

grub> cat /etc/issue
Debian GNU/Linux 8 \n \l

5 - Recherche de partitions

5.1 - A partir d'une étiquette ou d'une uuid

• Afficher l'identifiant grub de la partition d'étiquette "jessie"

grub> search --label jessie
(hd0,msdos1)

• Passer l'identifiant grub de la partition d'étiquette "jessie" au paramètre root (ou à tout autre paramètre)
  

grub> search --label --set=root jessie
grub> echo $root
hd0,msdos1

• Passer l'identifiant grub de la partition dont on connaît l'uuid au paramètre root
  

grub> search --fs-uuid --set=root xxxxx-xxxx-xxxx-xxxx-xxxxxx
grub> echo $root
hd0,msdos1

5.2 - Contenant un fichier de nom donné

• Rechercher les partitions contenant un fichier /vmlinuz (le chemin complet doit-être indiqué)

grub> search --file /vmlinuz
(hd0,msdos1)

• Rechercher la partition contenant le fichier /vmlinuz et passer sa valeur au paramètre root :

grub> search --file --set=root /vmlinuz
grub> echo $root
hd0,msdos1

6 - Commandes

6.1 - Aide à la saisie et à l'affichage

• Auto-completion ou suggestion : utiliser la touche TAB en cours de saisie. Cette fonction s'applique aux commandes et noms ou chemins de fichiers

• Circulation dans l'historique des commandes : flèches Haut et Bas

• Pour éviter que la page ne défile lorsque la sortie dépasse la taille de l'écran, positionner le paramètre pager à 1

grub> set pager=1

6.2 - Liste des commandes et aide

• Liste des commandes [Présentation sur deux colonnes]

grub> help

• Liste des commandes [Présentation en ligne]

grub> (Touche tabulation)

• Aide sur une commande

grub> help (Nom de la commande)

6.3 - Disponibilité des commandes

• Quelques commandes sont systématiquement disponibles (set, pager, ...). Les autres sont fournies par des modules (un module fournit une ou plusieurs commandes) qui doivent être préalablement chargés : voir Modules

• Le fichier command.list présent dans /boot/grub/<plate-forme>/ liste les commandes et les modules correspondants et permet donc de connaître la liste des commandes fournies par un module et inversement le module fournissant une commande donnée. Par exemple, la commande lsmod est fournie par le module minicmd :
  

$ cat /boot/grub/x86_64-efi/command.lst |grep lsmod
lsmod: minicmd

6.4 - Commandes diverses

• Accès au Mode Menu (On suppose le module normal chargé et grub.cfg dans le répertoire désigné par ($root)
• Forme longue
  

grub> normal ($root)/grub.cfg

• Forme courte : Touche ESC
• Mode Rescue

grub> normal_exit

• Arrêt du système
  

grub> insmod halt
grub> halt

• Redémarrage du système
  

grub> insmod reboot
grub> reboot

• Lancement de l'interface UEFI (si la plate-forme a été amorcée en mode UEFI

grub> fwsetup

7 - Modules

• Liste des modules chargés et leurs dépendances
  

grub> lsmod

• Chargement d'un module

• Forme longue- Cas d'amorçage MBR/Bios
  

grub> insmod $prefix/i386-pc/hello.mod

• Forme longue - Cas d'amorçage UEFI

grub> insmod $prefix/x86_64/hello.mod

• Forme implicite (nom du module sans extension, sans indication de chemin)

grub> insmod hello

• Déchargement d'un module
  

grub> rmmod date

Note : si un module est chargé plusieurs fois (ce qui est indiqué dans la colonne Nombre ci-dessus), il faudra le décharger plusieurs fois pour qu'il ne soit plus disponible

8 - Précautions

8.1 - Erreurs sur les noms de variables et leur valeur

Attention : Aucun contrôle n'est effectué sur les noms de variable et leur valeur. Dans l'exemple ci-dessous, on veut donner à la valeur root, la valeur hd0,msdos1, mais ....

grub> set ro0t=hd0,msdos1   # ici, on crée une nouveau paramètre : ro0t
grub> set root=hdO,msdos1     # là, on donne une mauvaise valeur :  hdO,msdos1
grub> set root=hd0,msdos1        # Ouf! La variabe root est créée avec la bonne valeur : hd0,msdos1

8.2 - Confusion entre les variables, les commandes et les modules

Rien ne distingue dans leurs noms, les variables, les commandes et des modules : keymap est une commande, lang est une variable, videoinfo est le nom du module qui fournir la commande homonyme. Il est donc assez facile de faire une erreur en prenant l'un pour l'autre.

• keymap est une commande dont la syntaxe est du type commande chemin de fichier. Si, au lieu de

grub> keymap /boot/grub/layouts/fr.gkb

on tape :

grub> set keymap=/boot/grub/layouts/fr.gkb

le système ne détectera pas d'erreur et créera la variable keymap, ce qui n'était pas l'effet souhaité.

• Par contre, l'utilisation d'un nom de variable comme commande est détecté par le système. Si, au lieu de

grub> set lang=FR

on tape :

grub> lang FR
erreur : impossible de trouver la commmande " lang ".

le système affiche un message d'erreur.

8.3 - Préfixes

Noter que la variable root est défini sans parenthèses, alors que le paramètre prefix est défini avec des parenthèses

grub> echo $root
hd0,msdos1
grub> echo $prefix
(hd0,msdos1)/boot/grub/

Ainsi

ls $root génère une erreur et doit-être écrit ls ($root)
ls $prefix est correct