From 152c70894417121d43406270bb9f4815e7089b74 Mon Sep 17 00:00:00 2001 From: David Sterba Date: Wed, 24 Apr 2024 15:35:09 +0200 Subject: [PATCH] btrfs-progs: docs: update feature status Add some missing entries. Changes to supported levels: - increase to 6.8 from 6.7 where applicable, there were fixes to squota and temp-fsid - raid-stripe-tree declares support from 6.7, however this is still behind CONFIG_BTRFS_DEBUG option in kernel, there are some bugs and the known lack of RAID56 support [ci skip] Signed-off-by: David Sterba --- Documentation/Status.rst | 14 +++++++------- Documentation/btrfs-man5.rst | 10 ++++++++++ Documentation/mkfs.btrfs.rst | 11 ++++++++--- 3 files changed, 25 insertions(+), 10 deletions(-) diff --git a/Documentation/Status.rst b/Documentation/Status.rst index 71395497..5e8706ee 100644 --- a/Documentation/Status.rst +++ b/Documentation/Status.rst @@ -13,7 +13,7 @@ in meeting your performance expectations for your specific workload. Combination of features can vary in performance, the table does not cover all possibilities. -**The table is based on the latest released linux kernel: 6.7** +**The table is based on the latest released linux kernel: 6.8** The columns for each feature reflect the status of the implementation in following ways: @@ -124,8 +124,8 @@ in following ways: - OK - * - Temporary FSID - - 6.7 - - 6.7 + - 6.8 + - 6.8 - Single devices with same FSID can be mounted repeatedly, getting a temporary UUID. * - :doc:`Seeding` - :statusok:`OK` @@ -136,8 +136,8 @@ in following ways: - mostly OK - qgroups with many snapshots slows down balance * - :doc:`Squota, simplified qgroups` - - 6.7 - - 6.7 + - 6.8 + - 6.8 - simplified qgroup accounting, better performance, specific use case * - :doc:`Swapfile` - :statusok:`OK` @@ -239,9 +239,9 @@ converted later). - OK - * - :ref:`Raid stripe tree` - - :statusok:`OK` + - :statusmok:`mostly OK` - OK - - + - not all profiles are supported and RST is behind CONFIG_BTRFS_DEBUG build option * - :doc:`Squota` - :statusok:`OK` - OK diff --git a/Documentation/btrfs-man5.rst b/Documentation/btrfs-man5.rst index 098e8ce3..ca9a4efe 100644 --- a/Documentation/btrfs-man5.rst +++ b/Documentation/btrfs-man5.rst @@ -141,6 +141,11 @@ raid1c34 extended RAID1 mode with copies on 3 or 4 devices respectively +raid_stripe_tree + (since: 6.7) + + a separate tree for tracking file extents on RAID profiles + RAID56 (since: 3.9) @@ -162,6 +167,11 @@ send_stream_version number of the highest supported send stream version +simple_quota + (since: 6.7) + + simplified quota accounting + supported_checksums (since: 5.5) diff --git a/Documentation/mkfs.btrfs.rst b/Documentation/mkfs.btrfs.rst index f2dd1086..3253ebf1 100644 --- a/Documentation/mkfs.btrfs.rst +++ b/Documentation/mkfs.btrfs.rst @@ -346,15 +346,20 @@ block-group-tree .. _mkfs-feature-raid-stripe-tree: raid-stripe-tree - (kernel support since 6.7) + (kernel support since 6.7, CONFIG_BTRFS_DEBUG) - New tree for logical file extent mapping where the physical mapping - may not match on multiple devices. this is now used in zoned mode to + Separate tree for logical file extent mapping where the physical mapping + may not match on multiple devices. This is now used in zoned mode to implement RAID0/RAID1* profiles, but can be used in non-zoned mode as well. The support for RAID56 is in development and will eventually fix the problems with the current implementation. This is a backward incompatible feature and has to be enabled at mkfs time. + .. note:: + Due to the status of implementation it is enabled only in + builds with CONFIG_BTRFS_DEBUG. Support by the kernel module + can be found in the sysfs feature list. + squota (kernel support since 6.7)