Skip to content

Commit 6912bdb

Browse files
nir9Jonathan Corbet
authored and
Jonathan Corbet
committed
Documentation: Fix x86_64 UEFI outdated references to elilo
Problem: The x86_64 UEFI doc references Elilo which is an unmaintained/orphaned bootloader project. Also, on x86_64 a bootloader is technically not actually required since there is support for the Linux EFI stub. Solution: Remove the references to Elilo from the doc and refer to the EFI stub doc page, update steps accordingly, and add more details about creation of the EFI partition to improve clarity. Signed-off-by: Nir Lichtman <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Jonathan Corbet <[email protected]>
1 parent e129fdc commit 6912bdb

File tree

1 file changed

+27
-10
lines changed

1 file changed

+27
-10
lines changed

Documentation/arch/x86/x86_64/uefi.rst

+27-10
Original file line numberDiff line numberDiff line change
@@ -12,14 +12,20 @@ with EFI firmware and specifications are listed below.
1212

1313
1. UEFI specification: http://www.uefi.org
1414

15-
2. Booting Linux kernel on UEFI x86_64 platform requires bootloader
16-
support. Elilo with x86_64 support can be used.
15+
2. Booting Linux kernel on UEFI x86_64 platform can either be
16+
done using the <Documentation/admin-guide/efi-stub.rst> or using a
17+
separate bootloader.
1718

1819
3. x86_64 platform with EFI/UEFI firmware.
1920

2021
Mechanics
2122
---------
2223

24+
Refer to <Documentation/admin-guide/efi-stub.rst> to learn how to use the EFI stub.
25+
26+
Below are general EFI setup guidelines on the x86_64 platform,
27+
regardless of whether you use the EFI stub or a separate bootloader.
28+
2329
- Build the kernel with the following configuration::
2430

2531
CONFIG_FB_EFI=y
@@ -31,16 +37,27 @@ Mechanics
3137
CONFIG_EFI=y
3238
CONFIG_EFIVAR_FS=y or m # optional
3339

34-
- Create a VFAT partition on the disk
35-
- Copy the following to the VFAT partition:
40+
- Create a VFAT partition on the disk with the EFI System flag
41+
You can do this with fdisk with the following commands:
42+
43+
1. g - initialize a GPT partition table
44+
2. n - create a new partition
45+
3. t - change the partition type to "EFI System" (number 1)
46+
4. w - write and save the changes
47+
48+
Afterwards, initialize the VFAT filesystem by running mkfs::
49+
50+
mkfs.fat /dev/<your-partition>
51+
52+
- Copy the boot files to the VFAT partition:
53+
If you use the EFI stub method, the kernel acts also as an EFI executable.
54+
55+
You can just copy the bzImage to the EFI/boot/bootx64.efi path on the partition
56+
so that it will automatically get booted, see the <Documentation/admin-guide/efi-stub.rst> page
57+
for additional instructions regarding passage of kernel parameters and initramfs.
3658

37-
elilo bootloader with x86_64 support, elilo configuration file,
38-
kernel image built in first step and corresponding
39-
initrd. Instructions on building elilo and its dependencies
40-
can be found in the elilo sourceforge project.
59+
If you use a custom bootloader, refer to the relevant documentation for help on this part.
4160

42-
- Boot to EFI shell and invoke elilo choosing the kernel image built
43-
in first step.
4461
- If some or all EFI runtime services don't work, you can try following
4562
kernel command line parameters to turn off some or all EFI runtime
4663
services.

0 commit comments

Comments
 (0)