From: Thomas Schmitt Date: Thu, 20 Jun 2019 08:36:42 +0000 (+0200) Subject: docs: Document workaround for grub-mkrescue with older MacBooks X-Git-Tag: grub-2.04~1 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f9811a92e6d4c0579f989f3d6dcc66e8fb35cb09;p=thirdparty%2Fgrub.git 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 --- 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