From c5787173b8f3b42c3763ae1bf3ef1ef6c0cb9e64 Mon Sep 17 00:00:00 2001 From: Colm Date: Fri, 20 Oct 2023 09:25:04 +0100 Subject: [PATCH] Update bpool creation note to reflect compatibility property. The current note does not correctly explain how the ``compatibility`` property allows us to keep bpool compatible with GRUB. Updating the note to reflect the current command. --- .../Debian/Debian Bookworm Root on ZFS.rst | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/Getting Started/Debian/Debian Bookworm Root on ZFS.rst b/docs/Getting Started/Debian/Debian Bookworm Root on ZFS.rst index 55d5b2f04..2ab0f1c23 100644 --- a/docs/Getting Started/Debian/Debian Bookworm Root on ZFS.rst +++ b/docs/Getting Started/Debian/Debian Bookworm Root on ZFS.rst @@ -244,15 +244,15 @@ Step 2: Disk Formatting -O canmount=off -O mountpoint=/boot -R /mnt \ bpool ${DISK}-part3 - You should not need to customize any of the options for the boot pool. - - GRUB does not support all of the zpool features. See ``spa_feature_names`` - in `grub-core/fs/zfs/zfs.c - `__. - This step creates a separate boot pool for ``/boot`` with the features - limited to only those that GRUB supports, allowing the root pool to use - any/all features. Note that GRUB opens the pool read-only, so all - read-only compatible features are “supported” by GRUB. + *Note:* GRUB does not support all zpool features (see + ``spa_feature_names`` in + `grub-core/fs/zfs/zfs.c `_). + We create a separate zpool for ``/boot`` here, specifying the + ``-o compatibility=grub2`` property which restricts the pool to only those + features that GRUB supports, allowing the root pool to use any/all features. + + See the section on ``Compatibility feature sets`` in the ``zpool-features`` + man page for more information. **Hints:**