{
    "mode": "man",
    "parameter": "era_restore",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/era_restore/8/json",
    "generated": "2026-10-08T08:54:10Z",
    "synopsis": "erarestore [options] -i {xml file} -o {device|file}",
    "sections": {
        "NAME": {
            "content": "erarestore - restore era metadata file to device or file.\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "erarestore [options] -i {xml file} -o {device|file}\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "erarestore  restores era metadata created by the respective device-mapper target dumped into\nan XML formatted (see eradump(8)) file, which optionally can be preprocessed before the  re‐\nstore  to  another  device  or  file.  If  restored to a metadata device, the metadata can be\nprocessed by the device-mapper target.\n\nThis tool cannot be run on live metadata.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "",
            "subsections": [
                {
                    "name": "-h, --help",
                    "content": "Print help and exit.\n",
                    "flag": "-h",
                    "long": "--help"
                },
                {
                    "name": "-V, --version",
                    "content": "Print version information and exit.\n",
                    "flag": "-V",
                    "long": "--version"
                },
                {
                    "name": "-q, --quiet",
                    "content": "Don't print any output.  Check the exit code to test for success.\n",
                    "flag": "-q",
                    "long": "--quiet"
                },
                {
                    "name": "-i, --input {xml file}",
                    "content": "Specify input file containing xml metadata.\n",
                    "flag": "-i",
                    "long": "--input"
                },
                {
                    "name": "-o, --output {device|file}",
                    "content": "Output device or file for restored binary metadata.\n\nIf a file is used, then it must be preallocated, and large enough to hold\nthe metadata.\n\n",
                    "flag": "-o",
                    "long": "--output"
                }
            ]
        },
        "EXAMPLE": {
            "content": "Restores the XML formatted era metadata on file metadata to logical  volume  /dev/vg/metadata\nfor further processing by the respective device-mapper target:\n\n$ erarestore -i metadata -o /dev/vg/metadata\n\n",
            "subsections": []
        },
        "DIAGNOSTICS": {
            "content": "erarestore returns an exit code of 0 for success or 1 for error.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "eradump(8), eracheck(8)\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "Joe Thornber <ejt@redhat.com>, Heinz Mauelshagen <HeinzM@RedHat.com>\n\nSystem Manager's Manual                  Device Mapper Tools                          erarestore(8)",
            "subsections": []
        }
    },
    "summary": "erarestore - restore era metadata file to device or file.",
    "flags": [
        {
            "flag": "-h",
            "long": "--help",
            "arg": null,
            "description": "Print help and exit."
        },
        {
            "flag": "-V",
            "long": "--version",
            "arg": null,
            "description": "Print version information and exit."
        },
        {
            "flag": "-q",
            "long": "--quiet",
            "arg": null,
            "description": "Don't print any output. Check the exit code to test for success."
        },
        {
            "flag": "-i",
            "long": "--input",
            "arg": null,
            "description": "Specify input file containing xml metadata."
        },
        {
            "flag": "-o",
            "long": "--output",
            "arg": null,
            "description": "Output device or file for restored binary metadata. If a file is used, then it must be preallocated, and large enough to hold the metadata."
        }
    ],
    "examples": [
        "Restores the XML formatted era metadata on file metadata to logical  volume  /dev/vg/metadata",
        "for further processing by the respective device-mapper target:",
        "$ erarestore -i metadata -o /dev/vg/metadata"
    ],
    "see_also": [
        {
            "name": "eradump",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/eradump/8/json"
        },
        {
            "name": "eracheck",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/eracheck/8/json"
        }
    ]
}