diff mbox series

[1/2] design: document the new inode btree counter feature

Message ID 160384741848.1365004.5354796889293226533.stgit@magnolia
State New
Headers show
Series xfs-documentation: format updates for 5.10 | expand

Commit Message

Darrick J. Wong Oct. 28, 2020, 1:10 a.m. UTC
From: Darrick J. Wong <darrick.wong@oracle.com>

Update the ondisk format documentation to discuss the inode btree
counter feature.

Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
 .../allocation_groups.asciidoc                     |   21 ++++++++++++++++++++
 1 file changed, 21 insertions(+)
diff mbox series


diff --git a/design/XFS_Filesystem_Structure/allocation_groups.asciidoc b/design/XFS_Filesystem_Structure/allocation_groups.asciidoc
index 992615d..2e78f56 100644
--- a/design/XFS_Filesystem_Structure/allocation_groups.asciidoc
+++ b/design/XFS_Filesystem_Structure/allocation_groups.asciidoc
@@ -405,6 +405,13 @@  reference counts of AG blocks.  This enables files to share data blocks safely.
 See the section about xref:Reflink_Deduplication[reflink and deduplication] for
 more details.
+Inode B+tree block counters.  Each allocation group's inode (AGI) header
+tracks the number of blocks in each of the inode B+trees.  This allows us
+to have a slightly higher level of redundancy over the shape of the inode
+btrees, and decreases the amount of time to compute the metadata B+tree
+preallocations at mount time.
@@ -928,6 +935,10 @@  struct xfs_agi {
      __be32              agi_free_root;
      __be32              agi_free_level;
+     __be32              agi_iblocks;
+     __be32              agi_fblocks;
@@ -984,6 +995,16 @@  B+tree.
 Specifies the number of levels in the free inode B+tree.
+The number of blocks in the inode B+tree, including the root.
+This field is zero if the +XFS_SB_FEAT_RO_COMPAT_INOBTCNT+ feature is not
+The number of blocks in the free inode B+tree, including the root.
+This field is zero if the +XFS_SB_FEAT_RO_COMPAT_INOBTCNT+ feature is not
 == Inode B+trees