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
9

SYNOPSIS

11       thin_dump [options] {device|file}
12
13

DESCRIPTION

15       thin_dump dumps binary  thin  provisioning  metadata  (optionally  from
16       alternate block; see option --metadata-snap) created by the device-map‐
17       per thin provisioning target on a device or file to standard output for
18       analysis or postprocessing in either XML or human readable format.  XML
19       formated metadata can be fed into thin_restore (see thin_restore(8)) in
20       order  to put it back onto a metadata device (to process by the device-
21       mapper target) or file.
22
23       This tool cannot be run on live  metadata  unless  the  --metadata-snap
24       option is used.
25
26
27       -f, --format {xml|human_readable}
28       Print output in XML or human readable format.
29
30
31       -r, --repair
32       Repair the metadata whilst dumping it.
33
34
35       -m, --metadata-snap[=block#]
36       Dump  metadata snapshot created by device-mapper thin provisioning tar‐
37       get.  If block is not provided, access the  default  metadata  snapshot
38       created by the thin provisioning device-mapper target, else try the one
39       at block#.  See the thin provisioning target documentation  on  how  to
40       create  or  release  a  metadata snapshot and retrieve the block number
41       from the kernel.
42
43
44       -h, --help
45       Print help and exit.
46
47
48       -V, --version
49       Output version information and exit.
50
51

EXAMPLES

53       Dumps the thin provisioning metadata on logical volume /dev/vg/metadata
54       to standard output in human readable format:
55
56       thin_dump -f human_readable /dev/vg/metadata
57
58       Dumps the thin provisioning metadata on logical volume /dev/vg/metadata
59       to standard output in XML format:
60
61       thin_dump /dev/vg/metadata
62
63       Dumps  the  thin  provisioning  metadata  snapshot  on  logical  volume
64       /dev/vg/metadata  to standard output in human readable format (not pro‐
65       cessable by thin_restore(8) ):
66
67       thin_dump --format human_readable --metadata-snap /dev/vg/metadata
68
69

DIAGNOSTICS

71       thin_dump returns an exit code of 0 for success or 1 for error.
72
73

SEE ALSO

75       thin_check(8) thin_repair(8)  thin_restore(8)  thin_rmap(8)  thin_meta‐
76       data_size(8)
77

AUTHOR

79       Joe Thornber <ejt@redhat.com>
80       Heinz Mauelshagen <HeinzM@RedHat.com>
81
82
83
84Red Hat, Inc.               Thin Provisioning Tools               THIN_DUMP(8)
Impressum