From nobody Mon Nov 13 16:29:26 2023 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 4STZdL4KZMz51KpB for ; Mon, 13 Nov 2023 16:29:26 +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 "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4STZdL3tD0z3fb5; Mon, 13 Nov 2023 16:29:26 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1699892966; 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=EdmMD7apKGAm5bQcTF6n6vtgFD1QOY6Zs15kDMXtBA0=; b=HSbzMEMPcWp8DS1B0IYdnIUV9zl6J7wJ/ldALKejVEeL6a0pAXidOStKw9iAmhqB5bkUui w00GmOgPH+YG4eGF8FSmPiz9azxITOXxY79pIgbPyEb09uzG8P1L8ZXyam/Xq6UQtrpFlP ryRdZe48K0CEXOSiI/uOpbKW6YxfL/g9amFApe7oMHke4mDjamCNNZqRxyJPOnzCyXNFpJ tfSefNrTswVw21SCJZOHPUw3K7DWT2DQnFPztvKOhuiRrJa7JwUkixE02Mu+ZVb2V/QSgl 7dlyxvujU5RL1X8HLEEDn6n5C/vdi91EyzPRrQiFRyq/czKlOuZhkkGGNDwiPw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1699892966; 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=EdmMD7apKGAm5bQcTF6n6vtgFD1QOY6Zs15kDMXtBA0=; b=yFR1T/sMZM4It7BYtAXlyOG7jF9zMs8NyJ2GNrmMQJjFEJfWOsQfZ8WU7JRZjZdVRwVYC0 VqGsU/M0jR9UhVUM7LRuTXfYsguY4ysc91V+ZlfccekCH7IUJlmtOLj1BhERNc9u1P7lbH Az78H7shxKElZp/Rlq4zad7wn9ks4G8l5LXYO/7vR/Hvq/hX0QvAqsOKaVqVkCyS5XvvsN TsU9Bdsx20uz9ooLb1wM820gm4NmyAc/EDM3553QLMkDdc79qVzdnsNVwGxNS+MnykobDX uE7qJ/yXyAFRo8jnPMKsuZfi1oSwEJck8PTIP4CYlIU5UvY+LfS+8u2mCu5ghA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1699892966; a=rsa-sha256; cv=none; b=Q42l6cKuUWSxtRzv8slfFjbe2+f586s7DxYgX/8VXplKhEut69/A/jIO9VjKfdDOFGmCqZ 1BvanzMFjW/amuYMqxBtwDmPPxrUzfCSajGjQcZSF+3jLXh7A8I/QekZinJ3f97vvLON/9 PyV22ZvG9xYTaY5l/8z8lgmUZtCtydqJlSA8RBfSnKyPxkXQSQgCuW3u6bRol0G4i2fPNb kYf3OHYCzJGULwfYTyHmeST8n5KaXfQrAcIi9XA6TYnwV0iqJBuHTb7Nll9bNTzPc/JWes YHMahARtUY5MhlD9E5lXIg0GWXPsQxT822wDoT2xPfuSgqI38MfeMh5w+tuR3Q== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4STZdL2d5Wz19p5; Mon, 13 Nov 2023 16:29:26 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 3ADGTQdZ060525; Mon, 13 Nov 2023 16:29:26 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 3ADGTQ4D060522; Mon, 13 Nov 2023 16:29:26 GMT (envelope-from git) Date: Mon, 13 Nov 2023 16:29:26 GMT Message-Id: <202311131629.3ADGTQ4D060522@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mike Karels Subject: git: 8e5ff76f82 - main - 14.0 relnotes: recommend updating EFI boot loader when booting UFS 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: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: karels X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 8e5ff76f821b408b4917a742b2a44016ff1daa2e Auto-Submitted: auto-generated The branch main has been updated by karels: URL: https://cgit.FreeBSD.org/doc/commit/?id=8e5ff76f821b408b4917a742b2a44016ff1daa2e commit 8e5ff76f821b408b4917a742b2a44016ff1daa2e Author: Mike Karels AuthorDate: 2023-11-13 16:27:26 +0000 Commit: Mike Karels CommitDate: 2023-11-13 16:29:11 +0000 14.0 relnotes: recommend updating EFI boot loader when booting UFS UFS root file systems do not have the same issues as ZFS for the boot loader, but the boot loader should still be updated. Generalize the section on updating the ESP. ZFS must be done before zpool update, UFS should be done. Discussed with: imp Differential Revision: https://reviews.freebsd.org/D42549 --- website/content/en/releases/14.0R/relnotes.adoc | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/website/content/en/releases/14.0R/relnotes.adoc b/website/content/en/releases/14.0R/relnotes.adoc index 333871180b..c9e3e0c3ff 100644 --- a/website/content/en/releases/14.0R/relnotes.adoc +++ b/website/content/en/releases/14.0R/relnotes.adoc @@ -63,9 +63,11 @@ Note that freebsd-update cannot be used to roll back to the previous release aft Source-based upgrades (those based on recompiling the FreeBSD base system from source code) from previous versions are supported, according to the instructions in [.filename]#/usr/src/UPDATING#. -Note for systems that boot from a ZFS root filesystem via EFI, using either binary or source upgrades: -There are one or more copies of the boot loader on the MS-DOS EFI System Partition (ESP), used by the firmware to boot the kernel, and which must be able to support reading from the ZFS boot file system. +Note for systems that boot via EFI, using either binary or source upgrades: +There are one or more copies of the boot loader on the MS-DOS EFI System Partition (ESP), used by the firmware to boot the kernel. +If the root file system is ZFS, the boot loader must be able to support reading from the ZFS boot file system. After a system upgrade, but before doing a `zpool upgrade`, the boot loader on the ESP must be updated, or the system may become unbootable. +While not mandatory, this update procedure should also be followed when using a UFS root file system. The location of the boot loader in use can be determined using the command `efibootmgr -v`. The value displayed for `BootCurrent` should be the number of the current boot configuration used to boot the system. The corresponding entry of the output should begin with a `+` sign, such as