xfs_metadump is a debugging tool that copies the metadata from an XFS filesystem to a file.
source argument must be the pathname of the device or file
containing the XFS filesystem and the
target argument specifies the destination file name.
target is -, then the output is sent to stdout. This allows the output to be
redirected to another program such as a compression application.
xfs_metadump should only be used to copy unmounted filesystems, read-only mounted
filesystems, or frozen filesystems (see
Otherwise, the generated dump could be inconsistent or corrupt.
xfs_metadump does not alter the source filesystem in any way. The
target image is a contiguous (non-sparse) file containing all the
filesystems metadata and indexes to where the blocks were copied from.
xfs_metadump obfuscates most file (regular file, directory and symbolic link) names
and extended attribute names to allow the dumps to be sent without
revealing confidential information. Extended attribute values are zeroed
and no data is copied. The only exceptions are file or attribute names
that are 4 or less characters in length. Also file names that span extents
(this can only occur with the
size) are not obfuscated. Names between 5 and 8 characters in length inclusively
are partially obfuscated.
xfs_metadump should not be used for any purposes other than for debugging and reporting
filesystem problems. The most common usage scenario for this tool is when
fails to repair a filesystem and a metadump image can be sent for
The file generated by
xfs_metadump can be restored to filesystem image (minus the data) using the