Debian Codegraph @

upstream/debian-unstable/man8/xfs_mdrestore.8

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