.TH ERA_DUMP 8 "Thin Provisioning Tools" "Red Hat, Inc." \" -*- nroff -*-
.SH NAME
era_dump \- dump era metadata from device or file to standard output

.SH SYNOPSIS
.B era_dump
.RB [options]
.I {device|file}

.SH DESCRIPTION
.B era_dump
dumps binary era metadata created by the device-mapper
era target on a
.I device
or
.I file
to standard output for
analysis or postprocessing in XML format.
XML formated metadata can be fed into era_restore (see
.BR era_restore(8) )
in order to put it back onto a metadata
.I device
(to process by the device-mapper target) or
.I file.

This tool cannot be run on live metadata.

.IP "\fB\-r, \-\-repair\fP".
Repair the metadata whilst dumping it.

.IP "\fB\-h, \-\-help\fP".
Print help and exit.

.IP "\fB\-V, \-\-version\fP".
Output version information and exit.

.IP "\fB\-\-logical\fP".
Fold any unprocessed write sets into the final era array.  You
probably want to do this if you're intending to process the results as
it simplifies the XML.

.SH EXAMPLES
Dumps era metadata on logical volume /dev/vg/metadata
to standard output in XML format:
.sp
.B era_dump /dev/vg/metadata

.SH DIAGNOSTICS
.B era_dump
returns an exit code of 0 for success or 1 for error.

.SH SEE ALSO
.B era_check(8)
.B era_repair(8)
.B era_restore(8)
.B era_invalidate(8)
.SH AUTHOR
Joe Thornber <ejt@redhat.com>