From nobody Mon Apr 27 19:24:36 2026 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4g4D622n4hz6bW3T for ; Mon, 27 Apr 2026 19:24:42 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R13" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4g4D622FLqz3CR1 for ; Mon, 27 Apr 2026 19:24:42 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1777317882; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=L6tpM9dDIoHZyDAdrVOFZzTSiT+UV9Man9gJW3ryN2o=; b=GQoFdCJj7L4pBV+wIDVIG6saS8RcEE7nKJYh1I6Bqk0tKwZlnrXPPxD2sgUmLCHa5ZTbzy et9LaFrupbqRzcgW4uIfGYtrxvWLRrnzuYIH2iA9LlRsoa4SZy1iemDjoAoqUnyduuQgFo xhRx0VFFBDu2UIBHOxZP4bQQwi6GX05C+Qnk0AIZTvScZokOJfu52e4jCNtCb5h/EOrbr8 N9wiE3iXGhnabujPNw0HG4U6ThAQzWoxF+FY+FmGjM59QGAf6DS16zAMteiLY8aXYlt+Lj WtBOYPvOtfLgS9MRNEPi1ISP5y+LoeXAuZV0hVDqdtxlPzGz+juDHMf6/7Vt7w== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1777317882; a=rsa-sha256; cv=none; b=BBt7EMjw+ChnqFPr27K1pfDBWHmi1wx2BHtYVFUfnVolnqgNKTtmKfkOwtCFjV4RbplvS/ O3ipRaMFIVg0IiTLvS4vwdEflx8MsOi9muaOl/J4JFGGLoPJ1whN6USDXcqBdCFEtCBGeL pPI8/0jv1z0lzP6BwANVmNuBaEf5M8Qm9td3B4bY7wIxpPdtE6whKqow/7ePqAtzjEg27v Y9FZHpgMObyqaQb/+Q9yZ7ACTbrNMg0TWoGa/osP69+FGs1zr6kbsur62Hmd7RIzFwzAsi GHf7AB/ailR9tYcOKFxsL23dD/rTqHKKtjyR23LYChEOc94lkU66VbMkTHcFFA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1777317882; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=L6tpM9dDIoHZyDAdrVOFZzTSiT+UV9Man9gJW3ryN2o=; b=UeSfE9kEr/Dgz2LKs/aLQGoJx2k6HUiIytNyII56FzbKwulbS0dYY8hs5Urq2eMoUaqn5x W4OIIIjo1RncVkJc+EitkWWO/pdouCsc211TTv63HQ+5kW6hUkoKHy/hkfgZ0EDqgd8XnI mTsN4LWJKZFxlKTOyGBL2zlzXf3rPHSzhFJtEL/VAKGQxJaPKrxLa3kSckT1P3WA6Es9zV 6i0omRnyLzyTKbeX8S7b7SD1k8Q8h1fjul2/v7YeWNxY6GLgv9+Dii9hynIs2ZM9B9xcIK nFhLK5oAB2nO62WMyHwuksnymSE15WqEE96IteSfDcY89ZEyKUNgpSKxjOt3Eg== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4g4D621gHvz56h for ; Mon, 27 Apr 2026 19:24:42 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 30e17 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Mon, 27 Apr 2026 19:24:36 +0000 To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: f8d0c45d7f - main - Fix instructions for writing the ZFS bootcode on EFI systems List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: f8d0c45d7f71a7e5e539188b4662eba41fd9513a Auto-Submitted: auto-generated Date: Mon, 27 Apr 2026 19:24:36 +0000 Message-Id: <69efb7f4.30e17.5a4b600d@gitrepo.freebsd.org> The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=f8d0c45d7f71a7e5e539188b4662eba41fd9513a commit f8d0c45d7f71a7e5e539188b4662eba41fd9513a Author: Benedict Reuschling AuthorDate: 2026-04-27 19:17:00 +0000 Commit: Benedict Reuschling 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. ====