From 81abb915afd4cf2e558ff5eeda430b2f17cd09eb Mon Sep 17 00:00:00 2001 From: "Darrick J. Wong" Date: Wed, 20 Nov 2024 16:24:14 -0800 Subject: [PATCH] man: update scrub ioctl documentation for metadir Update the scrub ioctl manpage to reflect the new metadir path scrubber. Signed-off-by: "Darrick J. Wong" Reviewed-by: Christoph Hellwig --- man/man2/ioctl_xfs_scrub_metadata.2 | 44 +++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) diff --git a/man/man2/ioctl_xfs_scrub_metadata.2 b/man/man2/ioctl_xfs_scrub_metadata.2 index 44aa139b..1e7e327b 100644 --- a/man/man2/ioctl_xfs_scrub_metadata.2 +++ b/man/man2/ioctl_xfs_scrub_metadata.2 @@ -200,6 +200,50 @@ Scan all inodes in the filesystem to verify each file's link count. Mark everything healthy after a clean scrub run. This clears out all the indirect health problem markers that might remain in the system. + +.TP +.B XFS_SCRUB_TYPE_METAPATH +Check that a metadata directory path actually points to the active metadata +inode. +Metadata inodes are usually cached for the duration of the mount, so this +scrubber ensures that the same inode will still be reachable after an unmount +and mount cycle. +Discrepancies can happen if the directory or parent pointer scrubbers rebuild +a metadata directory but lose a link in the process. +The +.B sm_ino +field should be passed one of the following special values to communicate which +path to check: + +.RS 7 +.TP +.B XFS_SCRUB_METAPATH_RTDIR +Realtime metadata file subdirectory. +.TP +.B XFS_SCRUB_METAPATH_RTBITMAP +Realtime bitmap file. +.TP +.B XFS_SCRUB_METAPATH_RTSUMMARY +Realtime summary file. +.TP +.B XFS_SCRUB_METAPATH_QUOTADIR +Quota metadata file subdirectory. +.TP +.B XFS_SCRUB_METAPATH_USRQUOTA +User quota file. +.TP +.B XFS_SCRUB_METAPATH_GRPQUOTA +Group quota file. +.TP +.B XFS_SCRUB_METAPATH_PRJQUOTA +Project quota file. +.RE + +The values of +.I sm_agno +and +.I sm_gen +must be zero. .RE .PD 1 -- 2.47.3