Commit 62a84ded authored by Thomas Petazzoni's avatar Thomas Petazzoni Committed by Peter Korsgaard
Browse files

grub: improve help text with detailed instructions to install grub 



These instructions should probaby go in the Buildroot manual, but at
this point, it's not clear in which section they should go. So in
order to not loose those notes, add them to the Grub help text.

Signed-off-by: default avatarThomas Petazzoni <thomas.petazzoni@free-electrons.com>
Signed-off-by: default avatarPeter Korsgaard <peter@korsgaard.com>
parent 1cece281

boot/grub/Config.in

+30 −0
Original line number Diff line number Diff line
@@ -5,6 +5,36 @@ config BR2_TARGET_GRUB 
	help

	  The GRand Unified Bootloader for x86 systems.



	  Some notes on creating a disk image with Grub installed:

	    1. Create an empty disk image

	       dd if=/dev/zero of=disk.img bs=1M count=32

	    2. Create one primary partition

	       cfdisk -h 16 -s 63 disk.img

	    3. Set up a loop device

	       sudo losetup -f disk.img

	    4. Set up loop devices per partitions

	       sudo partx -a /dev/loop0

	    5. Create the ext2 filesystem

	       sudo mkfs.ext2 -L root /dev/loop0p1

	    6. Mount the filesystem

	       mount /dev/loop0p1 /mnt

	    7. Extract the root filesystem

	       sudo tar -C /mnt -xf output/images/rootfs.tar

	    8. Unmount the filesystem, clean up loop device

	       sudo umount /mnt

	       sudo partx -d /dev/loop0

	       sudo losetup -d /dev/loop0

	    9. Install grub

	       output/host/sbin/grub --device-map=/dev/null

	       and in the grub shell, enter:

		device (hd0) disk.img

		geometry (hd0) <cylinders> 16 63

		root (hd0,0)

		setup (hd0)

	    10. Image is ready

		Can be tested in Qemu, with:

		  qemu-system-{i386,x86-64} -hda disk.img



if BR2_TARGET_GRUB



config BR2_TARGET_GRUB_SPLASH