cbwww/site/docs/grub/index.md

1.9 KiB

title x-toc-enable
GRUB payload true

Keymaps are stored in resources/grub/keymap/

You can use the ckbcomp program to generate a keymap, based on Xorg keymap files:

ckbcomp fr > frazerty

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

When you've built GRUB, using gbmk (nonGeNUine Boot build system), take your kepmap file (generated by ckbcomp) and run it through grub-mklayout like so:

cat frazerty | ./grub/grub-mklayout -o frazerty.gkb

Place the newly created .gkb file under resources/grub/keymap in gbmk. When you build nonGeNUine Boot, a ROM image with GRUB payload and your newly created keymap will be available under the bin/ directory. Learn how to build nonGeNUine Boot ROM images

Many keymaps exist in the nonGeNUine Boot build system, but sometimes you must 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 automatically add all keymaps in GRUB.

If you've added a keymap to gbmk, and it works, please submit a patch!