Skip to contentSkip to conversation

docs: workaround for grub-mkrescue with older MacBooks

PATCH New Thomas Schmitt 1 participant 1 message Jun 20, 2019

lore
Share & tools
lore
#0 lore raw

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.

---

docs/grub.texi +12 -0
index 308b250..a9b38e9 100644
@@ -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