From f9811a92e6d4c0579f989f3d6dcc66e8fb35cb09 Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Thu, 20 Jun 2019 10:36:42 +0200 Subject: [PATCH] docs: Document workaround for grub-mkrescue with older MacBooks Add a description of the workaround for firmware of older MacBooks which stalls with a grub-mkrescue ISO image for x86_64-efi target on an USB stick. Signed-off-by: Thomas Schmitt Reviewed-by: Daniel Kiper --- docs/grub.texi | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/grub.texi b/docs/grub.texi index 308b25074..87795075a 100644 --- a/docs/grub.texi +++ b/docs/grub.texi @@ -6131,6 +6131,7 @@ Required files are: @menu * GRUB only offers a rescue shell:: +* Firmware stalls instead of booting GRUB:: @end menu @@ -6201,6 +6202,17 @@ support has not yet been added to GRUB. @end itemize +@node Firmware stalls instead of booting GRUB +@section Firmware stalls instead of booting GRUB + +The EFI implementation of some older MacBook laptops stalls when it gets +presented a grub-mkrescue ISO image for x86_64-efi target on an USB stick. +Affected are models of year 2010 or earlier. Workaround is to zeroize the +bytes 446 to 461 of the EFI partition, where mformat has put a partition table +entry which claims partition start at block 0. This change will not hamper +bootability on other machines. + + @node Invoking grub-install @chapter Invoking grub-install