1thin_dump(8)                System Manager's Manual               thin_dump(8)
2
3
4

NAME

6       thin_dump  -  dump  thin  provisioning  metadata from device or file to
7       standard output.
8

SYNOPSIS

10       thin_dump [options] {device|file}
11

DESCRIPTION

13       thin_dump dumps binary  thin  provisioning  metadata  (optionally  from
14       alternate block; see option --metadata-snap) created by the device-map‐
15       per thin provisioning target on a device or file to standard output for
16       analysis or postprocessing in either XML or human readable format.  XML
17       formated metadata can be fed into thin_restore (see thin_restore(8)) in
18       order  to put it back onto a metadata device (to process by the device-
19       mapper target) or file.
20
21       This tool cannot be run on live  metadata  unless  the  --metadata-snap
22       option is used.
23

OPTIONS

25       -h, --help
26              Print help and exit.
27
28       -V, --version
29              Print version information and exit.
30
31       -f, --format {xml|human_readable|custom}
32              Choose output format.
33
34           Custom formats are supported via shared library plugins.  They should be
35           specified as in this example:
36
37             $ thin_dump --format custom=mylib.so /dev/sda
38
39
40       -r, --repair
41              Repair the metadata whilst dumping it.
42
43       -m, --metadata-snap{=<block nr>}
44              Dump metadata snapshot.
45
46           If block is not provided, access the default metadata snapshot created by
47           the thin provisioning device-mapper target, else try the one at block nr.
48           See the thin provisioning target documentation on how to create or release
49           a metadata snapshot and retrieve the block number from the kernel.
50
51
52       --dev-id {natural}
53              Dump the specified device.
54
55           This option may be specified multiple times to select more than one thin
56           device.
57
58
59       --skip-mappings
60              Do not dump the mappings.
61
62       -o {xml file}
63              Specify a file for the output rather than writing to stdout.
64

EXAMPLES

66       Dumps the thin provisioning metadata on logical volume /dev/vg/metadata
67       to standard output in human readable format:
68
69           $ thin_dump -f human_readable /dev/vg/metadata
70
71       Dumps the thin provisioning metadata on logical volume /dev/vg/metadata
72       to standard output in XML format:
73
74           $ thin_dump /dev/vg/metadata
75
76       Dumps  the  thin  provisioning  metadata  snapshot  on  logical  volume
77       /dev/vg/metadata to standard output in human readable format (not  pro‐
78       cessable by thin_restore(8)):
79
80           $ thin_dump --format human_readable --metadata-snap /dev/vg/metadata
81
82

DIAGNOSTICS

84       thin_dump returns an exit code of 0 for success or 1 for error.
85

SEE ALSO

87       thin_check(8),     thin_repair(8),    thin_restore(8),    thin_rmap(8),
88       thin_metadata_size(8)
89

AUTHOR

91       Joe Thornber <ejt@redhat.com>, Heinz Mauelshagen <HeinzM@RedHat.com>
92
93
94
95System Manager's Manual       Device Mapper Tools                 thin_dump(8)
Impressum