xfs\_mdrestore(8) System Manager's Manual xfs\_mdrestore(8)

# [NAME](#NAME)

xfs\_mdrestore - restores an XFS metadump image to a filesystem image

# [SYNOPSIS](#SYNOPSIS)

**xfs\_mdrestore** \[ **-gi** ] *source* *target*  
**xfs\_mdrestore** **-i** *source*  
**xfs\_mdrestore -V**

# [DESCRIPTION](#DESCRIPTION)

**xfs\_mdrestore** is a debugging tool that restores a metadata image generated by [**xfs\_metadump**(8)](/man/enterprise-packages/xfsprogs-5.10/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](#OPTIONS)

[**-g**](#g)

Shows restore progress on stdout.

[**-i**](#i)

Shows metadump information on stdout. If no *target* is specified, exits after displaying information. Older metadumps man not include any descriptive information.

[**-V**](#V)

Prints the version number and exits.

# [DIAGNOSTICS](#DIAGNOSTICS)

**xfs\_mdrestore** returns an exit code of 0 if all the metadata is successfully restored or 1 if an error occurs.

# [SEE ALSO](#SEE_ALSO)

[**xfs\_metadump**(8)](/man/enterprise-packages/xfsprogs-5.10/xfs_metadump.8), [**xfs\_repair**(8)](/man/enterprise-packages/xfsprogs-5.10/xfs_repair.8), [**xfs**(5)](/man/enterprise-packages/xfsprogs-5.10/xfs.5)

# [BUGS](#BUGS)

Email bug reports to **linux-xfs@vger.kernel.org**.

---

Document: xfs_mdrestore(8) from xfsprogs-5.10 5.10.0-r47 (Chainguard OS)
Source: https://kernel.googlesource.com/pub/scm/fs/xfs/xfsprogs-dev