GNUBoot/gnuboot
GNUBoot
/
gnuboot
mirror of https://git.savannah.gnu.org/git/gnuboot.git
2
1
Fork 0
Code Issues Releases Activity

website: docs: grub: review and add GNU Boot context. 

Signed-off-by: Denis 'GNUtoo' Carikli <GNUtoo@cyberdimension.org>
Acked-by: Adrien Bourmault <neox@gnu.org>
This commit is contained in:
Denis 'GNUtoo' Carikli 2024-11-11 22:07:49 +01:00 committed by Adrien 'neox' Bourmault
parent 3e5b8a0d6e
commit 1d4738d24a
Signed by: neox
GPG Key ID: 57BC26A3687116F6
1 changed files with 8 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
website/pages/docs/grub/index.md
View File

@ -1,17 +1,16 @@
--- ---
title: GRUB payload title: GRUB payload
x-unreviewed: true
... ...
TODO: this guide should be reviewed and updated. Some info might be out of TODO: this guide should be reviewed and updated. Some info might be out of
date. date.
[GNU GRUB](https://www.gnu.org/software/grub/) already has excellent [GNU GRUB](https://www.gnu.org/software/grub/) already has excellent
documentation, but there are aspects of Libreboot that deserve special documentation, but there are aspects of GNU Boot that deserve special
treatment. Libreboot provides the option to boot GNU GRUB directly, running on treatment. GNU Boot provides the option to boot GNU GRUB directly, running on
bare metal (instead of using BIOS or UEFI services). bare metal (instead of using BIOS or UEFI services).
[The GNU+Linux section](../gnulinux/) also has Libreboot-specific guides for [The GNU+Linux section](../gnulinux/) also has GNU Boot specific guides for
dealing with GNU+Linux distributions when using GNU GRUB directly, in this dealing with GNU+Linux distributions when using GNU GRUB directly, in this
setup. [A similar section exists for BSD operating systems](../bsd/) setup. [A similar section exists for BSD operating systems](../bsd/)
@ -33,17 +32,17 @@ files:
When you build GRUB from source, you can use the `grub-mklayout` program to When you build GRUB from source, you can use the `grub-mklayout` program to
create a special keymap file for GRUB. [Learn how to build GRUB](../build/) create a special keymap file for GRUB. [Learn how to build GRUB](../build/)
When you've built GRUB, using `lbmk` (libreboot build system), take your kepmap When you've built GRUB, using GNU Boot, take your kepmap file (generated by
file (generated by ckbcomp) and run it through `grub-mklayout` like so: ckbcomp) and run it through `grub-mklayout` like so:
cat frazerty | ./grub/grub-mklayout -o frazerty.gkb cat frazerty | ./grub/grub-mklayout -o frazerty.gkb
Place the newly created `.gkb` file under `resources/grub/keymap` in lbmk. When Place the newly created `.gkb` file under `resources/grub/keymap` in lbmk. When
you build Libreboot, a ROM image with GRUB payload and your newly created you build GNU Boot, an image with GRUB payload and your newly created
keymap will be available under the `bin/` directory. keymap will be available under the `bin/` directory.
[Learn how to build Libreboot ROM images](../build/) [Learn how to build GNU Boot images](../build/)
Many keymaps exist in the Libreboot build system, but sometimes you must Many keymaps exist in the GNU Boot build system, but sometimes you must
manually tweak the file created by `ckbcomp`, adjusting the scan codes in that manually tweak the file created by `ckbcomp`, adjusting the scan codes in that
file, before converting to a GRUB keymap file. Therefore, it would be unwise to file, before converting to a GRUB keymap file. Therefore, it would be unwise to
automatically add all keymaps in GRUB. automatically add all keymaps in GRUB.