.\" Text automatically generated by txt2man
.TH era_invalidate 8 "Device Mapper Tools" "System Manager's Manual"
.SH NAME
\fBera_invalidate \fP- Provide a list of blocks that have changed since a particular era.
\fB
.SH SYNOPSIS
.nf
.fam C
\fBera_invalidate\fP [\fIoptions\fP] {device|file}

.fam T
.fi
.fam T
.fi
.SH DESCRIPTION
\fBera_invalidate\fP examines era metadata and lists blocks that may have changed
since a given era.
.PP
This tool cannot be run on live metadata unless the \fB--metadata-snap\fP option is
used.
.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-o\fP {output file}
Write output to a file rather than stdout.
.TP
.B
\fB--metadata-snapshot\fP
Use the metadata snapshot rather than the current superblock.
.TP
.B
\fB--written-since\fP {era nr}
Blocks written since the given era will be listed.
.SH EXAMPLE
List the blocks that may have been written since the beginning of era 13 on the
metadata device /dev/vg/metadata:
.PP
.nf
.fam C
    $ era_invalidate --written-since 13 /dev/vg/metadata

.fam T
.fi
The device may not be actively used by the target when running.
.SH DIAGNOSTICS
\fBera_invalidate\fP returns an exit code of 0 for success or 1 for error (eg,
metadata corruption).
.SH SEE ALSO
\fBera_check\fP(8), \fBera_dump\fP(8), \fBera_restore\fP(8)
.SH AUTHOR
Joe Thornber <ejt@redhat.com>