aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorJybz <j.biernacki@free.fr>2019-12-30 11:03:16 +0100
committerJybz <j.biernacki@free.fr>2019-12-30 11:03:16 +0100
commit68db69c9bf00d33c4b64ede6de770bdaa03efc34 (patch)
tree305869825cd724bcbeb11ddb0e31a3bb8be07d72 /README.md
parent1a545d74b352e51de19b9a734c6a7fb72a0b58e6 (diff)
downloadmageia4arm-68db69c9bf00d33c4b64ede6de770bdaa03efc34.tar
mageia4arm-68db69c9bf00d33c4b64ede6de770bdaa03efc34.tar.gz
mageia4arm-68db69c9bf00d33c4b64ede6de770bdaa03efc34.tar.bz2
mageia4arm-68db69c9bf00d33c4b64ede6de770bdaa03efc34.tar.xz
mageia4arm-68db69c9bf00d33c4b64ede6de770bdaa03efc34.zip
Improve extlinux.conf doc and process.
Diffstat (limited to 'README.md')
-rw-r--r--README.md42
1 files changed, 38 insertions, 4 deletions
diff --git a/README.md b/README.md
index ccc10e1..334ddf2 100644
--- a/README.md
+++ b/README.md
@@ -108,8 +108,25 @@ Si l'une de ces fonctions ne retourne pas 0, la création de l'image échoue.
<a id="fr_file-extlinux"/>
#### extlinux.conf
-Extlinux.conf est un script utilisé par le chargeur de démarrage (s'il est capable de le gérer, uboot le peut), pour spécifier le noyau à démarrer. Le script est normalement généré automatiquement par les outils de Mageia à chaque installation/mise à jour d'un noyau. Malheureusement, lors de la création d'une image de Mageia, l'outil refuse de générer ce fichier dans un chroot. For cette image, soit le fichier peut être omit, soit écrit par vous même.
-TODO : Comment spécifier la ligne de commande pour un matériel spécifique ?
+Extlinux.conf est un script utilisé par le chargeur de démarrage (s'il est capable de le gérer, uboot le peut), pour spécifier la version du noyau à démarrer. Le script est normalement généré automatiquement par les outils de Mageia à chaque installation/mise à jour d'un noyau. Malheureusement, lors de la création d'une image de Mageia en chroot, l'outil refuse de générer ce fichier, de plus si le fichier est manquant, lors de la mise à jour du noyau, l'outil de Mageia génère un fichier erroné avec des entrées vides que u-boot refuse.
+Il vaut mieux créer ce fichier, même s'il n'est pas primordiale. D'autant plus que lors de la mise à jour d'un noyau, l'outil de Mageia reprends les arguments de la commande de démarrage pour les nouvelles versions.
+
+La structure basique du fichier est :
+```
+default linux
+timeout 20
+menu title Welcome to Mageia-Minimal.
+
+label linux
+ kernel /boot/vmlinuz
+ initrd /boot/initrd.img
+ fdtdir /usr/lib/<FDTDIR>
+ append root=UUID=<UUID> <BOOT_ARGS>
+```
+Les balises :
+- <FDTDIR> est automatiquement généré par le script ./mageia4arm/create_arm_img_urpmi.sh
+- <UUID> est récupéré par le script ./mageia4arm/create_arm_img_urpmi.sh
+- <BOOT_ARGS> est défini dans le fichier ./mageia4arm/platforms/<LaPlateforme>/mageia4arm.cfg
<a id="fr_file-others"/>
#### Autres
@@ -283,8 +300,25 @@ If one of this functions does not return 0, the process is stoped.
<a id="en_file-extlinux"/>
#### extlinux.conf
-extlinux.conf is a script used by the bootloader (if it is able to handel, uboot does) in order to select specific kernel to start. This script is normaly automatically generated by Mageia's tools at each kernel installation/update. Unfortunately, when creating the image of Mageia, the tool refuse to generate the file in chroot. For the image, either the file can be omited, or write by yourself.
-TODO : How to specify the command line specific for an hardware ?
+extlinux.conf is a script used by the bootloader (if it is able to manage it, uboot does) in order to select specific kernel version to start with boot arguments. This script is normaly automatically generated by Mageia's tools at each kernel installation/update. Unfortunately, when creating the image of Mageia in chroot, the tool refuses to generate the file, moreover, if the file is missing, at the first kernel update, the tool will create it with empty entries which makes uboot failing to parse it.
+It is better to generate this file, even if it isn't mandatory. It is even better as the tool take into account the boot arguments of previous kernel and add it for the new one and regenerate automatically the file.
+
+The basic file is:
+```
+default linux
+timeout 20
+menu title Welcome to Mageia-Minimal.
+
+label linux
+ kernel /boot/vmlinuz
+ initrd /boot/initrd.img
+ fdtdir /usr/lib/<FDTDIR>
+ append root=UUID=<UUID> <BOOT_ARGS>
+```
+The tags :
+- <FDTDIR> is automatically generated by the script ./mageia4arm/create_arm_img_urpmi.sh
+- <UUID> is automatically reused bu the script ./mageia4arm/create_arm_img_urpmi.sh
+- <BOOT_ARGS> is defined in the configuration file ./mageia4arm/platforms/<LaPlateforme>/mageia4arm.cfg
<a id="en_file-others"/>
#### others