From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from lichtman.org (lichtman.org [149.28.33.109]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id CD1AD1E87B; Mon, 6 Jan 2025 22:48:35 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=149.28.33.109 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1736203717; cv=none; b=EUGoIIrLMgQaZaSPawiGoGPJcPv7fvzHyJuY9e60cNapduBbR5o7gPXJiM2yUUDyp59yDtSU8wjjYI3iydijT2csTTPKTNXzkGYgOrFUJpL24y4VldWn6IBJNijams2Trgxz/PqcBsRNev/Cbrnyulh8ihJ3Ld79KPW0wSJr9RU= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1736203717; c=relaxed/simple; bh=YNQj/36AXxSBiGP84RYpZv+kxKn6DTETvtqBQkdP/WU=; h=Date:From:To:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=hPGOuMP9OAV+HAKeyataOBwtxGC5NsycZu/hD5JZ8/cMHjbYiU72lcWL15V5WiqtJ9Gk5va1IW4TFBXwUWAZCVB9uhC9WDbD+wDaaqYoAMfF25K3axePAdl3RAUYaPTmwzo/1TIzC9iAnNRc9kmptXhziD7NZBOcMO4VEAWH0rE= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=lichtman.org; spf=pass smtp.mailfrom=lichtman.org; dkim=pass (2048-bit key) header.d=lichtman.org header.i=@lichtman.org header.b=XylOvbr+; arc=none smtp.client-ip=149.28.33.109 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=lichtman.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=lichtman.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=lichtman.org header.i=@lichtman.org header.b="XylOvbr+" Received: by lichtman.org (Postfix, from userid 1000) id EF6D41770E1; Mon, 6 Jan 2025 22:48:34 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=lichtman.org; s=mail; t=1736203715; bh=YNQj/36AXxSBiGP84RYpZv+kxKn6DTETvtqBQkdP/WU=; h=Date:From:To:Subject:References:In-Reply-To:From; b=XylOvbr+PkC/427NUCdQ+TZ1kat+JOlkpRMIQ+dbe5ZbZrNNc2+3w0IeYMfj+igXu HSn2TCQZdK+ijGnT5RZu5exiKbVagjBAEp04Y+TioQkzEYKvk0DomLI8aVRwZf9LYZ iYkTinvnwu5DMJRI1rkzQGunsAp+IVYE6FJGKxKQpBK53kCAqbhpOpJZxsYKJZ2J2s 56UW7biiCWgDfSu5udRoSoVQT3JSAFJR4dCtH3jW7YC2BCxVb22b2NzKaQKZ+4Qnpw c8G1h8rA29WjZV75ohNUWFZEck3B19P0leVlWDMsBAKEpIVS7iNIOzMyl1aN/iAww6 ptvfvoVA691Rg== Date: Mon, 6 Jan 2025 22:48:34 +0000 From: Nir Lichtman To: corbet@lwn.net, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, tglx@linutronix.de, mingo@redhat.com, bp@alien8.de, dave.hansen@linux.intel.com, x86@kernel.org, hpa@zytor.com Subject: Re: [PATCH] Documentation: Fix x86_64 UEFI outdated references to elilo Message-ID: <20250106224834.GA877610@lichtman.org> References: <20250106223526.GA877278@lichtman.org> Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20250106223526.GA877278@lichtman.org> On Mon, Jan 06, 2025 at 10:35:27PM +0000, Nir Lichtman wrote: > 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 > --- Adding also the x86 arch maintainers to the thread (forgot). > Documentation/arch/x86/x86_64/uefi.rst | 26 ++++++++++++++++---------- > 1 file changed, 16 insertions(+), 10 deletions(-) > > diff --git a/Documentation/arch/x86/x86_64/uefi.rst b/Documentation/arch/x86/x86_64/uefi.rst > index fbc30c9a071d..c056063f49d5 100644 > --- a/Documentation/arch/x86/x86_64/uefi.rst > +++ b/Documentation/arch/x86/x86_64/uefi.rst > @@ -12,14 +12,16 @@ 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 or using a separate bootloader. > > 3. x86_64 platform with EFI/UEFI firmware. > > Mechanics > --------- > > +Refer to for general setup guidelines on usage of the EFI stub, the following are setup specifics for EFI in general on the x86_64 platform. > + > - Build the kernel with the following configuration:: > > CONFIG_FB_EFI=y > @@ -31,16 +33,20 @@ 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/ > > - 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. > +- Copy the boot files to the VFAT partition: > + If you use the EFI stub method, the kernel acts also as an EFI executable, and 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 page for additional instructions regarding passage of kernel parameters and initramfs. > + 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. > -- > 2.39.5 >