On Wed, Jan 08, 2025 at 11:35:22AM +0000, Nir Lichtman wrote: > diff --git a/Documentation/arch/x86/x86_64/uefi.rst b/Documentation/arch/x86/x86_64/uefi.rst > index fbc30c9a071d..3949d83a9915 100644 > --- a/Documentation/arch/x86/x86_64/uefi.rst > +++ b/Documentation/arch/x86/x86_64/uefi.rst > @@ -12,14 +12,19 @@ with EFI firmware and specifications are listed below. > > 1. UEFI specification: http://www.uefi.org > > -2. Booting Linux kernel on UEFI x86_64 platform requires bootloader > - support. Elilo with x86_64 support can be used. > +2. Booting Linux kernel on UEFI x86_64 platform can either be > + done using the <Documentation/admin-guide/efi-stub.rst> or using a separate bootloader. > > 3. x86_64 platform with EFI/UEFI firmware. > > Mechanics > --------- > > +Refer to <Documentation/admin-guide/efi-stub.rst> to learn how to use the EFI stub. > + > +Below are general EFI setup guidelines on the x86_64 platform, > +regardless of whether you use the EFI stub or a separate bootloader. > + > - Build the kernel with the following configuration:: > > CONFIG_FB_EFI=y > @@ -31,16 +36,27 @@ Mechanics > CONFIG_EFI=y > CONFIG_EFIVAR_FS=y or m # optional > > -- Create a VFAT partition on the disk > -- Copy the following to the VFAT partition: > +- Create a VFAT partition on the disk with the EFI System flag > + You can do this with fdisk with the following commands: > + > + 1. g - initialize a GPT partition table > + 2. n - create a new partition > + 3. t - change the partition type to "EFI System" (number 1) > + 4. w - write and save the changes > + > + Afterwards, initialize the VFAT filesystem by running mkfs:: > + > + mkfs.fat /dev/<your-partition> > + > +- Copy the boot files to the VFAT partition: > + If you use the EFI stub method, the kernel acts also as an EFI executable. > + > + You can just copy the bzImage to the EFI/boot/bootx64.efi path on the partition > + so that it will automatically get booted, see the <Documentation/admin-guide/efi-stub.rst> page > + for additional instructions regarding passage of kernel parameters and initramfs. > > - elilo bootloader with x86_64 support, elilo configuration file, > - kernel image built in first step and corresponding > - initrd. Instructions on building elilo and its dependencies > - can be found in the elilo sourceforge project. > + If you use a custom bootloader, refer to the relevant documentation for help on this part. > > -- Boot to EFI shell and invoke elilo choosing the kernel image built > - in first step. > - If some or all EFI runtime services don't work, you can try following > kernel command line parameters to turn off some or all EFI runtime > services. Looks good, thanks! Reviewed-by: Bagas Sanjaya <bagasdotme@xxxxxxxxx> -- An old man doll... just what I always wanted! - Clara
Attachment:
signature.asc
Description: PGP signature
