Date: Mon, 27 Apr 2026 19:24:36 +0000 From: Benedict Reuschling <bcr@FreeBSD.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org Subject: git: f8d0c45d7f - main - Fix instructions for writing the ZFS bootcode on EFI systems Message-ID: <69efb7f4.30e17.5a4b600d@gitrepo.freebsd.org>
index | next in thread | raw e-mail
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. ====home | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?69efb7f4.30e17.5a4b600d>