Skip to content

Commit f9811a9

Browse files
scdbackupDaniel Kiper
authored andcommitted
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 <scdbackup@gmx.net> Reviewed-by: Daniel Kiper <daniel.kiper@oracle.com>
1 parent ff999c8 commit f9811a9

File tree

1 file changed

+12
-0
lines changed

1 file changed

+12
-0
lines changed

docs/grub.texi

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6131,6 +6131,7 @@ Required files are:
61316131

61326132
@menu
61336133
* GRUB only offers a rescue shell::
6134+
* Firmware stalls instead of booting GRUB::
61346135
@end menu
61356136

61366137

@@ -6201,6 +6202,17 @@ support has not yet been added to GRUB.
62016202
@end itemize
62026203

62036204

6205+
@node Firmware stalls instead of booting GRUB
6206+
@section Firmware stalls instead of booting GRUB
6207+
6208+
The EFI implementation of some older MacBook laptops stalls when it gets
6209+
presented a grub-mkrescue ISO image for x86_64-efi target on an USB stick.
6210+
Affected are models of year 2010 or earlier. Workaround is to zeroize the
6211+
bytes 446 to 461 of the EFI partition, where mformat has put a partition table
6212+
entry which claims partition start at block 0. This change will not hamper
6213+
bootability on other machines.
6214+
6215+
62046216
@node Invoking grub-install
62056217
@chapter Invoking grub-install
62066218

0 commit comments

Comments
 (0)