xfs_mdrestore(8)           System Manager's Manual          xfs_mdrestore(8)

NAME         top

       xfs_mdrestore - restores an XFS metadump image to a filesystem image

SYNOPSIS         top

       xfs_mdrestore [ -gi ] source target
       xfs_mdrestore -i source
       xfs_mdrestore -V

DESCRIPTION         top

       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

       xfs_mdrestore should not be used to restore metadata onto an existing
       filesystem unless you are completely certain the target can be

OPTIONS         top

       -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.

       -V     Prints the version number and exits.

DIAGNOSTICS         top

       xfs_mdrestore returns an exit code of 0 if all the metadata is
       successfully restored or 1 if an error occurs.

SEE ALSO         top

       xfs_metadump(8), xfs_repair(8), xfs(5)

BUGS         top

       Email bug reports to

COLOPHON         top

       This page is part of the xfsprogs (utilities for XFS filesystems)
       project.  Information about the project can be found at 
       ⟨⟩.  If you have a bug report for this manual page,
       send it to  This page was obtained from
       the project's upstream Git repository
       ⟨⟩ on
       2019-09-26.  (At that time, the date of the most recent commit that
       was found in the repository was 2019-08-21.)  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


Pages that refer to this page: xfs_metadump(8)