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
12

DESCRIPTION

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

OPTIONS

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

EXAMPLES

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

DIAGNOSTICS

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

SEE ALSO

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

AUTHOR

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