era_invalidate(8)

era_invalidate8

Provide a list of blocks that have changed since a particular era.

Usage

era_invalidate [options] {device | file}

Overview

era_invalidate examines era metadata and lists blocks that may have changed since a given era.

This tool cannot be run on live metadata unless the --metadata-snap option is used.

Options

-h, --help

Print help and exit.

-V, --version

Print version information and exit.

-o {output file}

Write output to a file rather than stdout.

--metadata-snapshot

Use the metadata snapshot rather than the current superblock.

--written-since {era nr}

Blocks written since the given era will be listed.

Examples

List the blocks that may have been written since the beginning of era 13 on the metadata device /dev/vg/metadata:

    $ era_invalidate --written-since 13 /dev/vg/metadata

The device may not be actively used by the target when running.

Diagnostics

era_invalidate returns an exit code of 0 for success or 1 for error (eg, metadata corruption).

Releases

6 releases since Debian 9 (Stretch); the text changed 3 times.

  1. 9
  2. 10
  3. 11–12
  4. 13–Arch

--metadata-snapshot since Debian 10 (Buster).

Author

Joe Thornber <[email protected]>

From thin-provisioning-tools 1.3.4-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.