." Text automatically generated by txt2man
.TH cache_dump 8 "Device Mapper Tools" "System Manager's Manual"
.SH NAME
\fBcache_dump \fP- dump cache metadata from device or file to standard output.
\fB
.SH SYNOPSIS
.nf
.fam C
\fBcache_dump\fP [\fIoptions\fP] {device|file}
.fam T
.fi
.SH DESCRIPTION
\fBcache_dump\fP dumps binary cache metadata created by the device-mapper cache
target on a device or file to standard output for analysis or postprocessing
in XML format. XML formatted metadata can be fed into cache_restore in order
to put it back onto a metadata device (to process by the device-mapper
target), or file.
.PP
This tool cannot be run on live metadata.
.SH OPTIONS
.TP
.B
\fB-h\fP, \fB--help\fP
Print help and exit.
.TP
.B
\fB-V\fP, \fB--version\fP
Print version information and exit.
.TP
.B
\fB-r\fP, \fB--repair\fP
Repair the metadata whilst dumping it.
.TP
.B
\fB-o\fP {xml file}
Specify an output file for the xml, rather than printing to stdout.
.SH EXAMPLES
Dumps the cache metadata on logical volume /dev/vg/metadata to standard
output in XML format:
.PP
.nf
.fam C
    $ cache_dump /dev/vg/metadata

.fam T
.fi
Dumps the cache metadata on logical volume /dev/vg/metadata whilst repairing
it to standard output in XML format:
.PP
.nf
.fam C
    $ cache_dump --repair /dev/vg/metadata

.fam T
.fi
.SH DIAGNOSTICS
\fBcache_dump\fP returns an exit code of 0 for success or 1 for error.
.SH SEE ALSO
\fBcache_check\fP(8), \fBcache_repair\fP(8), \fBcache_restore\fP(8)
.SH AUTHOR
Joe Thornber <ejt@redhat.com>, Heinz Mauelshagen <HeinzM@RedHat.com>