xfs_mdrestore(8) — Linux manual page


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

NAME         top

       xfs_mdrestore - restores an XFS metadump image to a filesystem

SYNOPSIS         top

       xfs_mdrestore [ -gi ] [ -l logdev ] source target
       xfs_mdrestore -i [ -l logdev ] 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 device.

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

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.

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

       -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 linux-xfs@vger.kernel.org.

COLOPHON         top

       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 linux-xfs@vger.kernel.org.  This page was obtained
       from the project's upstream Git repository
       ⟨https://git.kernel.org/pub/scm/fs/xfs/xfsprogs-dev.git⟩ on
       2024-06-14.  (At that time, the date of the most recent commit
       that was found in the repository was 2024-05-17.)  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 man-pages@man7.org


Pages that refer to this page: xfs_metadump(8)