git: f8d0c45d7f - main - Fix instructions for writing the ZFS bootcode on EFI systems

The branch main has been updated by bcr:

URL: https://cgit.FreeBSD.org/doc/commit/?id=f8d0c45d7f71a7e5e539188b4662eba41fd9513a

commit f8d0c45d7f71a7e5e539188b4662eba41fd9513a
Author:     Benedict Reuschling <bcr@FreeBSD.org>
AuthorDate: 2026-04-27 19:17:00 +0000
Commit:     Benedict Reuschling <bcr@FreeBSD.org>
CommitDate: 2026-04-27 19:17:00 +0000

    Fix instructions for writing the ZFS bootcode on EFI systems
    
    The previous instructions used "gpart bootcode" which do not work
    anymore and result in broken boot on EFI systems. Change the
    instructions to mount the EFI partition first and then copy the boot
    loader file into the target directory on it. Add a note that the target
    file is architecture specific, pointing users to uefi(8) where the file
    names are listed per architecture.
    
    PR:                     293912
    Reviewed by:            imp
    Differential Revision:  https://reviews.freebsd.org/D56643
---
 documentation/content/en/books/handbook/zfs/_index.adoc | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/documentation/content/en/books/handbook/zfs/_index.adoc b/documentation/content/en/books/handbook/zfs/_index.adoc
index 587b6510e2..bd48735296 100644
--- a/documentation/content/en/books/handbook/zfs/_index.adoc
+++ b/documentation/content/en/books/handbook/zfs/_index.adoc
@@ -1349,9 +1349,15 @@ For systems using EFI to boot, execute the following command:
 
 [source,shell]
 ....
-# gpart bootcode -p /boot/boot1.efi -i 1 ada1
+# mount -t msdosfs /dev/ada1p1 /boot/efi
+# cp /boot/loader.efi /boot/efi/efi/boot/BOOTX64.efi
+# cp /boot/loader.efi /boot/efi/efi/freebsd/loader.efi
 ....
 
+These instructions apply to amd64 systems.
+Depending on the architecture, the file has a different name.
+Refer to man:uefi[8] to find the names of the architecture-specific files.
+
 Apply the bootcode to all bootable disks in the pool.
 See man:gpart[8] for more information.
 ====