Skip to content

Commit 152c708

Browse files
committed
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 <dsterba@suse.com>
1 parent 7f396f5 commit 152c708

File tree

3 files changed

+25
-10
lines changed

3 files changed

+25
-10
lines changed

Documentation/Status.rst

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ in meeting your performance expectations for your specific workload.
1313
Combination of features can vary in performance, the table does not
1414
cover all possibilities.
1515

16-
**The table is based on the latest released linux kernel: 6.7**
16+
**The table is based on the latest released linux kernel: 6.8**
1717

1818
The columns for each feature reflect the status of the implementation
1919
in following ways:
@@ -124,8 +124,8 @@ in following ways:
124124
- OK
125125
-
126126
* - Temporary FSID
127-
- 6.7
128-
- 6.7
127+
- 6.8
128+
- 6.8
129129
- Single devices with same FSID can be mounted repeatedly, getting a temporary UUID.
130130
* - :doc:`Seeding<Seeding-device>`
131131
- :statusok:`OK`
@@ -136,8 +136,8 @@ in following ways:
136136
- mostly OK
137137
- qgroups with many snapshots slows down balance
138138
* - :doc:`Squota, simplified qgroups<Qgroups>`
139-
- 6.7
140-
- 6.7
139+
- 6.8
140+
- 6.8
141141
- simplified qgroup accounting, better performance, specific use case
142142
* - :doc:`Swapfile<Swapfile>`
143143
- :statusok:`OK`
@@ -239,9 +239,9 @@ converted later).
239239
- OK
240240
-
241241
* - :ref:`Raid stripe tree<mkfs-feature-raid-stripe-tree>`
242-
- :statusok:`OK`
242+
- :statusmok:`mostly OK`
243243
- OK
244-
-
244+
- not all profiles are supported and RST is behind CONFIG_BTRFS_DEBUG build option
245245
* - :doc:`Squota<Qgroups>`
246246
- :statusok:`OK`
247247
- OK

Documentation/btrfs-man5.rst

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -141,6 +141,11 @@ raid1c34
141141

142142
extended RAID1 mode with copies on 3 or 4 devices respectively
143143

144+
raid_stripe_tree
145+
(since: 6.7)
146+
147+
a separate tree for tracking file extents on RAID profiles
148+
144149
RAID56
145150
(since: 3.9)
146151

@@ -162,6 +167,11 @@ send_stream_version
162167

163168
number of the highest supported send stream version
164169

170+
simple_quota
171+
(since: 6.7)
172+
173+
simplified quota accounting
174+
165175
supported_checksums
166176
(since: 5.5)
167177

Documentation/mkfs.btrfs.rst

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -346,15 +346,20 @@ block-group-tree
346346
.. _mkfs-feature-raid-stripe-tree:
347347

348348
raid-stripe-tree
349-
(kernel support since 6.7)
349+
(kernel support since 6.7, CONFIG_BTRFS_DEBUG)
350350

351-
New tree for logical file extent mapping where the physical mapping
352-
may not match on multiple devices. this is now used in zoned mode to
351+
Separate tree for logical file extent mapping where the physical mapping
352+
may not match on multiple devices. This is now used in zoned mode to
353353
implement RAID0/RAID1* profiles, but can be used in non-zoned mode as
354354
well. The support for RAID56 is in development and will eventually
355355
fix the problems with the current implementation. This is a backward
356356
incompatible feature and has to be enabled at mkfs time.
357357

358+
.. note::
359+
Due to the status of implementation it is enabled only in
360+
builds with CONFIG_BTRFS_DEBUG. Support by the kernel module
361+
can be found in the sysfs feature list.
362+
358363
squota
359364
(kernel support since 6.7)
360365

0 commit comments

Comments
 (0)