btrfs-progs: docs: formatting, fixups, updates

- update Status page
- new features in 6.7
- more ioctls
- CSS fix to wrap long lines in tables

[ci skip]

Signed-off-by: David Sterba <dsterba@suse.com>

Author: kdave

Documentation/Feature-by-version.rst

@@ -93,6 +93,16 @@ features see :doc:`Status<Status>` page.
         finalizing the directory, the cache also gains significant speedups (up
         to 10x).
 
+6.7 - raid-stripe-tree
+        New tree for logical mapping, allows some RAID modes for zoned mode.
+
+6.7 - simplified quota accounting
+        A simplified mode of qgroups accounting
+
+6.7 - temporary fsid
+        Mount of cloned devices is now possible, the filesystem will get a new
+        randomly generated UUID on mount
+
 5.x
 ---
 

Documentation/Introduction.rst

@@ -5,43 +5,45 @@ BTRFS is a modern copy on write (COW) filesystem for Linux aimed at
 implementing advanced features while also focusing on fault tolerance, repair
 and easy administration. Its main features and benefits are:
 
-* Snapshots which do not make a full copy of the files
-* Built-in volume management, support for software-based RAID 0, RAID 1, RAID 10 and others
-* Self-healing - checksums for data and metadata, automatic detection of silent data corruptions
+*  Snapshots which do not make a full copy of the files
+*  Built-in volume management, support for software-based RAID 0, RAID 1, RAID 10 and others
+*  Self-healing - checksums for data and metadata, automatic detection of silent data corruptions
 
 Feature overview:
 
-* Extent based file storage
-* 2\ :sup:`64` byte == 16 EiB maximum file size (practical limit is 8 EiB due to Linux VFS)
-* Space-efficient packing of small files
-* Space-efficient indexed directories
-* Dynamic inode allocation
-* Writable snapshots, read-only snapshots
-* Subvolumes (separate internal filesystem roots)
-* Checksums on data and metadata (crc32c, xxhash, sha256, blake2b)
-* Compression (ZLIB, LZO, ZSTD), heuristics
-* Integrated multiple device support
-   * File Striping
-   * File Mirroring
-   * File Striping+Mirroring
-   * Single and Dual Parity implementations (experimental, not production-ready)
-* SSD (flash storage) awareness (TRIM/Discard for reporting free blocks for
-  reuse) and optimizations (e.g. avoiding unnecessary seek optimizations,
-  sending writes in clusters, even if they are from unrelated files. This
-  results in larger write operations and faster write throughput)
-* Efficient incremental backup
-* Background scrub process for finding and repairing errors of files with redundant copies
-* Online filesystem defragmentation
-* Offline filesystem check
-* In-place conversion of existing ext2/3/4 and reiserfs file systems
-* Seed devices. Create a (readonly) filesystem that acts as a template to seed
-  other Btrfs filesystems. The original filesystem and devices are included as
-  a readonly starting point for the new filesystem. Using copy on write, all
-  modifications are stored on different devices; the original is unchanged.
-* Subvolume-aware quota support
-* Send/receive of subvolume changes
-   * Efficient incremental filesystem mirroring
-* Batch, or out-of-band deduplication (happens after writes, not during)
-* Swapfile support
-* Tree-checker, post-read and pre-write metadata verification
-* Zoned mode support (SMR/ZBC/ZNS friendly allocation)
+*  Extent based file storage
+*  2\ :sup:`64` byte == 16 EiB maximum file size (practical limit is 8 EiB due to Linux VFS)
+*  Space-efficient packing of small files
+*  Space-efficient indexed directories
+*  Dynamic inode allocation
+*  Writable snapshots, read-only snapshots
+*  Subvolumes (separate internal filesystem roots)
+*  Checksums on data and metadata (crc32c, xxhash, sha256, blake2b)
+*  Compression (ZLIB, LZO, ZSTD), heuristics
+*  Integrated multiple device support
+
+    *  File Striping
+    *  File Mirroring
+    *  File Striping+Mirroring
+    *  Single and Dual Parity implementations (experimental, not production-ready)
+*  SSD (flash storage) awareness (TRIM/Discard for reporting free blocks for
+   reuse) and optimizations (e.g. avoiding unnecessary seek optimizations,
+   sending writes in clusters, even if they are from unrelated files. This
+   results in larger write operations and faster write throughput)
+*  Efficient incremental backup
+*  Background scrub process for finding and repairing errors of files with redundant copies
+*  Online filesystem defragmentation
+*  Offline filesystem check
+*  In-place conversion of existing ext2/3/4 and reiserfs file systems
+*  Seed devices. Create a (readonly) filesystem that acts as a template to seed
+   other Btrfs filesystems. The original filesystem and devices are included as
+   a readonly starting point for the new filesystem. Using copy on write, all
+   modifications are stored on different devices; the original is unchanged.
+*  Subvolume-aware quota support
+*  Send/receive of subvolume changes
+
+    *  Efficient incremental filesystem mirroring
+*  Batch, or out-of-band deduplication (happens after writes, not during)
+*  Swapfile support
+*  Tree-checker, post-read and pre-write metadata verification
+*  Zoned mode support (SMR/ZBC/ZNS friendly allocation)

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.5**
+**The table is based on the latest released linux kernel: 6.6**
 
 The columns for each feature reflect the status of the implementation
 in following ways:
@@ -123,6 +123,10 @@ in following ways:
      - :statusok:`OK`
      - OK
      -
+   * - Temporary UUID
+     - 6.7
+     - 6.7
+     -
    * - :doc:`Seeding<Seeding-device>`
      - :statusok:`OK`
      - OK
@@ -131,6 +135,10 @@ in following ways:
      - :statusmok:`mostly OK`
      - mostly OK
      - qgroups with many snapshots slows down balance
+   * - :doc:`Quotas, simple qgroups<Qgroups>`
+     - 6.7
+     - 6.7
+     - simplified qgroup accounting, better performance
    * - :doc:`Swapfile<Swapfile>`
      - :statusok:`OK`
      - n/a
@@ -226,7 +234,11 @@ converted later).
      - :statusok:`OK`
      - OK
      -
-   * - :ref:`Block group tree`<mkfs-feature-block-group-tree>`
+   * - :ref:`Block group tree<mkfs-feature-block-group-tree>`
+     - :statusok:`OK`
+     - OK
+     -
+   * - :ref:`Raid stripe tree<mkfs-feature-raid-stripe-tree>`
      - :statusok:`OK`
      - OK
      -
@@ -321,7 +333,7 @@ are unaffected by the zoned device constraints.
      - Notes
    * - Boot
      - :statusincompat:`incompatible`
-     - The blocks where partition table is stored is used for super block
+     - The blocks where partition table is stored are used for super block
    * - Mixed block groups
      - :statusincompat:`incompatible`
      - Interleaving data and metadata would lead to out of order write
@@ -343,6 +355,12 @@ are unaffected by the zoned device constraints.
    * - Free space tree
      - :statusok:`supported`
      -
+   * - Block group tree
+     - :statusok:`supported`
+     -
+   * - Raid stripe tree
+     - :statusok:`supported`
+     - Allows to use RAID in zoned mode
    * - Filesystem resize
      - :statusok:`supported`
      -
@@ -352,9 +370,12 @@ are unaffected by the zoned device constraints.
    * - Metadata UUID change
      - :statusok:`supported`
      -
-   * - RAID (all)
+   * - RAID0, RAID1*
+     - :statusok:`supported`
+     - requires `raid-stripe-tree`
+   * - RAID56
      - not implemented
-     - This requires raid-stripe-tree feature which is still work in progress
+     - will be supported once raid-stripe-tree support is implemented
    * - discard
      - not implemented
      - May not be required at all due to automatic zone reclaim

Documentation/_static/style.css

@@ -2,6 +2,14 @@
     max-width: 1200px !important;
 }
 
+.wy-table-responsive {
+	white-space: normal !important;
+}
+
+.wy-table-responsive table td, .wy-table-responsive table th {
+	white-space: normal !important;
+}
+
 .green {
 	color: green;
 }