| 1 |
.TH xfs_mdrestore 8 |
| 2 |
.SH NAME |
| 3 |
xfs_mdrestore \- restores an XFS metadump image to a filesystem image |
| 4 |
.SH SYNOPSIS |
| 5 |
.B xfs_mdrestore |
| 6 |
[ |
| 7 |
.B \-gi |
| 8 |
] [ |
| 9 |
.B \-l |
| 10 |
.I logdev |
| 11 |
] [ |
| 12 |
.B \-r |
| 13 |
.I rtdev |
| 14 |
] |
| 15 |
.I source |
| 16 |
.I target |
| 17 |
.br |
| 18 |
.B xfs_mdrestore |
| 19 |
.B \-i |
| 20 |
[ |
| 21 |
.B \-l |
| 22 |
.I logdev |
| 23 |
] [ |
| 24 |
.B \-r |
| 25 |
.I rtdev |
| 26 |
] |
| 27 |
.I source |
| 28 |
.br |
| 29 |
.B xfs_mdrestore \-V |
| 30 |
.SH DESCRIPTION |
| 31 |
.B xfs_mdrestore |
| 32 |
is a debugging tool that restores a metadata image generated by |
| 33 |
.BR xfs_metadump (8) |
| 34 |
to a filesystem. The |
| 35 |
.I source |
| 36 |
argument specifies the location of the metadump image and the |
| 37 |
.I target |
| 38 |
argument specifies the destination for the filesystem image. |
| 39 |
If the |
| 40 |
.I source |
| 41 |
is \-, then the metadata image is read from stdin. This allows the output of |
| 42 |
be another program such as a compression application to be redirected to |
| 43 |
.BR xfs_mdrestore . |
| 44 |
The |
| 45 |
.I target |
| 46 |
can be either a file or a device. |
| 47 |
.PP |
| 48 |
.B xfs_mdrestore |
| 49 |
should not be used to restore metadata onto an existing filesystem unless |
| 50 |
you are completely certain the |
| 51 |
.I target |
| 52 |
can be destroyed. |
| 53 |
.PP |
| 54 |
.SH OPTIONS |
| 55 |
.TP |
| 56 |
.B \-g |
| 57 |
Shows restore progress on stdout. |
| 58 |
.TP |
| 59 |
.B \-i |
| 60 |
Shows metadump information on stdout. If no |
| 61 |
.I target |
| 62 |
is specified, exits after displaying information. Older metadumps man not |
| 63 |
include any descriptive information. |
| 64 |
.TP |
| 65 |
.BI \-l " logdev" |
| 66 |
Metadump in v2 format can contain metadata dumped from an external log. |
| 67 |
In such a scenario, the user has to provide a device to which the log device |
| 68 |
contents from the metadump file are copied. |
| 69 |
.TP |
| 70 |
.BI \-r " rtdev" |
| 71 |
Restore realtime device metadata to this device. |
| 72 |
This is only required for a metadump in v2 format. |
| 73 |
.TP |
| 74 |
.B \-V |
| 75 |
Prints the version number and exits. |
| 76 |
.SH DIAGNOSTICS |
| 77 |
.B xfs_mdrestore |
| 78 |
returns an exit code of 0 if all the metadata is successfully restored or |
| 79 |
1 if an error occurs. |
| 80 |
.SH SEE ALSO |
| 81 |
.BR xfs_metadump (8), |
| 82 |
.BR xfs_repair (8), |
| 83 |
.BR xfs (5) |
| 84 |
.SH BUGS |
| 85 |
Email bug reports to |
| 86 |
.BR [email protected] . |