docs: workaround for grub-mkrescue with older MacBooks
PATCH 1/1 docs: workaround for grub-mkrescue with older MacBooks
Description of the workaround for firmware of older MacBooks which stalls with a grub-mkrescue ISO image for platform "x86_64-efi" on a USB stick.
Signed-off-by Thomas Schmitt <[email protected]>
---
docs/grub.texi +12 -0
@@ -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 platform "x86_64-efi" on a +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