era_dump(8)

era_dump8

Dump era metadata from device or file to standard output.

Usage

era_dump [options] {device | file}

Overview

era_dump 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 era_restore(8)) in order to put it back onto a metadata device (to process by the device-mapper target) or file.

This tool cannot be run on live metadata.

Options

-h, --help

Print help and exit.

-V, --version

Print version information and exit.

--repair

Repair the metadata whilst dumping it.

--logical

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.
-o {xml file}

Specify a file for the output rather than writing to stdout.

Examples

Dumps era metadata on logical volume /dev/vg/metadata to standard output in XML format:

    $ era_dump /dev/vg/metadata

Diagnostics

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

Releases

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

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

-r until Debian 9 (Stretch).

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.