[Bug 293912] Handbook: section 22.3.11. wrong gpart instruction

From: <bugzilla-noreply_at_freebsd.org>
Date: Wed, 18 Mar 2026 22:46:48 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=293912

            Bug ID: 293912
           Summary: Handbook: section 22.3.11. wrong gpart instruction
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Some People
          Priority: ---
         Component: Books & Articles
          Assignee: doc@FreeBSD.org
          Reporter: jd.fbsd@goneja.de

The Handbook says in section 22.3.11. Upgrading a Storage Pool 
https://docs.freebsd.org/en/books/handbook/zfs/#zfs-zpool-upgrade 

"""
For systems using EFI to boot, execute the following command:

# gpart bootcode -p /boot/boot1.efi -i 1 ada1
"""

Please remove these lines.

This destroys the EFI partition, so that the computer cannot boot from it
anymore.

The correct instructions would be:
"""
# mount -t msdosfs /dev/ada1p1 /boot/efi
# cp /boot/loader.efi /boot/efi/EFI/BOOT/BOOTX64.efi
"""

But I think, updating the EFI loader should be explained in more detail
somewhere else in the Handbook.

-- 
You are receiving this mail because:
You are the assignee for the bug.