.\" Text automatically generated by txt2man
.TH era_dump 8 "Device Mapper Tools" "System Manager's Manual"
.SH NAME
\fBera_dump \fP- dump era metadata from device or file to standard output.
\fB
.SH SYNOPSIS
.nf
.fam C
\fBera_dump\fP [\fIoptions\fP] {device|file}

.fam T
.fi
.fam T
.fi
.SH DESCRIPTION
\fBera_dump\fP dumps binary era metadata created by the device-mapper era target on
a device or file to standard output for analysis or postprocessing in
XML format. XML formatted metadata can be fed into era_restore (see
\fBera_restore\fP(8)) 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--repair\fP
Repair the metadata whilst dumping it.
.TP
.B
\fB--logical\fP
Fold any unprocessed write sets into the final era array.
.PP
.nf
.fam C
    You probably want to do this if you're intending to process the results as
    it simplifies the XML.

.fam T
.fi
\fB-o\fP {xml file} Specify a file for the output rather than writing to stdout.
.SH EXAMPLES
Dumps era metadata on logical volume /dev/vg/metadata to standard output in
XML format:
.PP
.nf
.fam C
    $ era_dump /dev/vg/metadata

.fam T
.fi
.SH DIAGNOSTICS
\fBera_dump\fP returns an exit code of 0 for success or 1 for error.
.SH SEE ALSO
\fBera_check\fP(8), \fBera_restore\fP(8), \fBera_invalidate\fP(8)
.SH AUTHOR
Joe Thornber <ejt@redhat.com>