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

NAME

6       cache_dump  -  dump cache metadata from device or file to standard out‐
7       put.
8

SYNOPSIS

10       cache_dump [options] {device|file}
11

DESCRIPTION

13       cache_dump dumps binary cache metadata  created  by  the  device-mapper
14       cache  target  on  a  device or file to standard output for analysis or
15       postprocessing in XML format. XML formatted metadata can  be  fed  into
16       cache_restore  in  order  to  put  it  back  onto a metadata device (to
17       process by the device-mapper target), or file.
18
19       This tool cannot be run on live metadata.
20

OPTIONS

22       -h, --help
23              Print help and exit.
24
25       -V, --version
26              Print version information and exit.
27
28       -r, --repair
29              Repair the metadata whilst dumping it.
30
31       -o {xml file}
32              Specify an output file for the xml, rather than printing to std‐
33              out.
34

EXAMPLES

36       Dumps the cache metadata on logical volume /dev/vg/metadata to standard
37       output in XML format:
38
39           $ cache_dump /dev/vg/metadata
40
41       Dumps the cache metadata  on  logical  volume  /dev/vg/metadata  whilst
42       repairing it to standard output in XML format:
43
44           $ cache_dump --repair /dev/vg/metadata
45
46

DIAGNOSTICS

48       cache_dump returns an exit code of 0 for success or 1 for error.
49

SEE ALSO

51       cache_check(8), cache_repair(8), cache_restore(8)
52

AUTHOR

54       Joe Thornber <ejt@redhat.com>, Heinz Mauelshagen <HeinzM@RedHat.com>
55
56
57
58System Manager's Manual       Device Mapper Tools                cache_dump(8)