Skip to content

Commit ff6db76

Browse files
colmbuckleygmelikov
authored andcommitted
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.
1 parent b40d8c8 commit ff6db76

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

docs/Getting Started/Debian/Debian Bookworm Root on ZFS.rst

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -244,15 +244,15 @@ Step 2: Disk Formatting
244244
-O canmount=off -O mountpoint=/boot -R /mnt \
245245
bpool ${DISK}-part3
246246

247-
You should not need to customize any of the options for the boot pool.
248-
249-
GRUB does not support all of the zpool features. See ``spa_feature_names``
250-
in `grub-core/fs/zfs/zfs.c
251-
<http://git.savannah.gnu.org/cgit/grub.git/tree/grub-core/fs/zfs/zfs.c#n276>`__.
252-
This step creates a separate boot pool for ``/boot`` with the features
253-
limited to only those that GRUB supports, allowing the root pool to use
254-
any/all features. Note that GRUB opens the pool read-only, so all
255-
read-only compatible features are “supported” by GRUB.
247+
*Note:* GRUB does not support all zpool features (see
248+
``spa_feature_names`` in
249+
`grub-core/fs/zfs/zfs.c <https://git.savannah.gnu.org/cgit/grub.git/tree/grub-core/fs/zfs/zfs.c#288>`_).
250+
We create a separate zpool for ``/boot`` here, specifying the
251+
``-o compatibility=grub2`` property which restricts the pool to only those
252+
features that GRUB supports, allowing the root pool to use any/all features.
253+
254+
See the section on ``Compatibility feature sets`` in the ``zpool-features``
255+
man page for more information.
256256

257257
**Hints:**
258258

0 commit comments

Comments
 (0)