Attachment 245269 Details for Bug 255318 – signed-off .patch

[patch] signed-off .patch

255318.patch (text/plain), 3.44 KB, created by Graham Perrin on 2023-09-27 06:19:30 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Graham Perrin

Created: 2023-09-27 06:19:30 UTC

Size: 3.44 KB

patch

obsolete

>From: Graham Perrin <grahamperrin@gmail.com>
>Date: Wed, 27 Sep 2023 03:00:03 +0000
>Subject: [PATCH] FreeBSD Handbook: more about ESPs and bootcode
>
>Note that an upgrade to FreeBSD does not automatically upgrade the
>separate area that is typically used to boot the OS.  Some upgrade
>situations require an update to the EFI System Partition (ESP) or
>bootcode.
>
>Expand the section about updating ESPs or bootcode.  Refer to the
>EXAMPLES section of loader.efi(8).  Warn against inappropriate use of
>gpart(8).
>
>https://bugs.freebsd.org/255318
>
>PR:		255318
>Signed-off-by:	Graham Perrin <grahamperrin@gmail.com>
>---
> .../books/handbook/cutting-edge/_index.adoc   | 34 ++++++++++++++++---
> 1 file changed, 30 insertions(+), 4 deletions(-)
>
>diff --git a/documentation/content/en/books/handbook/cutting-edge/_index.adoc b/documentation/content/en/books/handbook/cutting-edge/_index.adoc
>index cf06f6df60..00ebbf2e66 100644
>--- a/documentation/content/en/books/handbook/cutting-edge/_index.adoc
>+++ b/documentation/content/en/books/handbook/cutting-edge/_index.adoc
>@@ -257,7 +257,14 @@ _Major version_ upgrades increase the major version number. An example:
> 
> Both types of upgrade can be performed by providing `freebsd-update` with a release version target.
> 
>-[WARNING]
>+[NOTE]
>+====
>+An upgrade to FreeBSD does *not* automatically upgrade the separate area that is typically used to boot the operating system.
>+
>+Some upgrade situations require an link:#updating-bootcode[update to the EFI System Partition (EFI) or bootcode].
>+====
>+
>+[NOTE]
> ====
> After each new `RELEASE`, FreeBSD package build servers will, for a limited period, *not* use the newer version of the operating system.
> This provides continuity for the many users who do not upgrade immediately after a release announcement.
>@@ -272,7 +279,6 @@ For example:
> So, with any minor or major OS upgrade, if your package requirements include any kernel module:
> 
> * *be prepared to build the module from source*.
>-
> ====
> 
> [NOTE]
>@@ -510,9 +516,29 @@ Kernel modules may differ as `freebsd-update` may have updated them.
> To exclude specific files or directories, add them to the `IDSIgnorePaths` option in [.filename]#/etc/freebsd-update.conf#.
> 
> [[updating-bootcode]]
>-== Updating Bootcode
>+== Updating EFI System Partitions (ESPs) or bootcode
> 
>-The following manuals describe the upgrade process of bootcode and boot loaders: man:gpart[8], man:gptboot[8], man:gptzfsboot[8], and man:loader.efi[8].
>+Related manual pages include:
>+
>+* man:gpart[8] -- control utility for the disk partitioning GEOM class
>+* man:gptboot[8] -- GPT bootcode for UFS on BIOS-based computers
>+* man:gptzfsboot[8] -- GPT bootcode for ZFS on BIOS-based computers
>+* man:loader.efi[8] -- UEFI kernel loader.
>+
>+The https://man.freebsd.org/cgi/man.cgi?query=loader.efi&sektion=8&manpath=freebsd-release#EXAMPLES[EXAMPLES] section of loader.efi(8) shows how to copy the [.filename]#loader.efi# file:
>+
>+* from an installation of FreeBSD
>+* to the proper path within an EFI System Partition (ESP).
>+
>+[WARNING]
>+====
>+Do *not* use the `bootcode` command of gpart(8) on a UEFI-based system that will run FreeBSD 13.0-RELEASE or greater.
>+====
>+
>+If a system uses multiple disks for redundancy: include the ESP, or bootcode, in redundancy.
>+For example:
>+
>+* if a partition with a UEFI-based installation of FreeBSD is mirrored from one disk to another, then both disks should have equally capable ESPs.
> 
> [[updating-upgrading-documentation]]
> == Updating the Documentation Set
>-- 
>2.30.8
>

Flags:

grahamperrin: maintainer-approval? (0mp)

Actions: View | Diff

Attachments on bug 255318: 245266 | 245268 | 245269