Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 14 Jun 2026 16:29:18 +0000
From:      Ahmad Khalifa <vexeduxr@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org
Subject:   git: 2e1f5b78976a - main - loader.efi(8): document the ia32 loader
Message-ID:  <6a2ed6de.416e7.493ab136@gitrepo.freebsd.org>

index | next in thread | raw e-mail

The branch main has been updated by vexeduxr:

URL: https://cgit.FreeBSD.org/src/commit/?id=2e1f5b78976ad09bee41e602e75e79a0c3892e59

commit 2e1f5b78976ad09bee41e602e75e79a0c3892e59
Author:     Ahmad Khalifa <vexeduxr@FreeBSD.org>
AuthorDate: 2026-06-14 16:26:30 +0000
Commit:     Ahmad Khalifa <vexeduxr@FreeBSD.org>
CommitDate: 2026-06-14 16:26:30 +0000

    loader.efi(8): document the ia32 loader
    
    Reviewed by:    kib
    MFC after:      3 days
    Differential Revision:  https://reviews.freebsd.org/D57569
---
 stand/man/loader.efi.8 | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/stand/man/loader.efi.8 b/stand/man/loader.efi.8
index ff43cbefe9bd..8ddc869e0a27 100644
--- a/stand/man/loader.efi.8
+++ b/stand/man/loader.efi.8
@@ -373,6 +373,18 @@ command produces a fault in the
 environment for testing purposes, by executing the
 .Ic ud2
 processor instruction.
+.Ss i386 firmware on amd64 machines
+Some devices have 64-bit (long mode) capable CPUs, but come with a
+32-bit (protected mode) UEFI implementation.
+.Pa /boot/loader_ia32.efi
+is provided for such devices.
+It switches to long mode right before executing the kernel.
+Note that since the firmware expects its runtime EFI functions to be
+executed in 32-bit protected mode, EFI runtime services are not
+available to the kernel.
+Which means that programs like
+.Xr efibootmgr 8
+will not work.
 .Sh FILES
 .Bl -tag -width "/boot/loader.efi"
 .It Pa /boot/loader.efi


home | help

Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?6a2ed6de.416e7.493ab136>