|
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | DIAGNOSTICS | SEE ALSO | BUGS | COLOPHON |
|
|
|
xfs_mdrestore(8) System Manager's Manual xfs_mdrestore(8)
xfs_mdrestore - restores an XFS metadump image to a filesystem
image
xfs_mdrestore [ -gi ] [ -l logdev ] [ -r rtdev ] source target
xfs_mdrestore -i [ -l logdev ] [ -r rtdev ] source
xfs_mdrestore -V
xfs_mdrestore is a debugging tool that restores a metadata image
generated by xfs_metadump(8) to a filesystem. The source argument
specifies the location of the metadump image and the target
argument specifies the destination for the filesystem image. If
the source is -, then the metadata image is read from stdin. This
allows the output of be another program such as a compression
application to be redirected to xfs_mdrestore. The target can be
either a file or a device.
xfs_mdrestore should not be used to restore metadata onto an
existing filesystem unless you are completely certain the target
can be destroyed.
-g Shows restore progress on stdout.
-i Shows metadump information on stdout. If no target is
specified, exits after displaying information. Older
metadumps man not include any descriptive information.
-l logdev
Metadump in v2 format can contain metadata dumped from an
external log. In such a scenario, the user has to provide
a device to which the log device contents from the metadump
file are copied.
-r rtdev
Restore realtime device metadata to this device. This is
only required for a metadump in v2 format.
-V Prints the version number and exits.
xfs_mdrestore returns an exit code of 0 if all the metadata is
successfully restored or 1 if an error occurs.
xfs_metadump(8), xfs_repair(8), xfs(5)
Email bug reports to [email protected].
This page is part of the xfsprogs (utilities for XFS filesystems)
project. Information about the project can be found at
⟨http://xfs.org/⟩. If you have a bug report for this manual page,
send it to [email protected]. This page was obtained from
the project's upstream Git repository
⟨https://git.kernel.org/pub/scm/fs/xfs/xfsprogs-dev.git⟩ on
2025-08-11. (At that time, the date of the most recent commit
that was found in the repository was 2025-06-23.) If you discover
any rendering problems in this HTML version of the page, or you
believe there is a better or more up-to-date source for the page,
or you have corrections or improvements to the information in this
COLOPHON (which is not part of the original manual page), send a
mail to [email protected]
xfs_mdrestore(8)
Pages that refer to this page: xfs_metadump(8)