{
    "mode": "man",
    "parameter": "era_invalidate",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/era_invalidate/8/json",
    "generated": "2026-07-05T11:58:20Z",
    "synopsis": "erainvalidate [options] {device|file}",
    "sections": {
        "NAME": {
            "content": "erainvalidate - Provide a list of blocks that have changed since a particular era.\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "erainvalidate [options] {device|file}\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "erainvalidate  examines  era  metadata  and lists blocks that may have changed since a given\nera.\n\nThis tool cannot be run on live metadata unless the --metadata-snap option is used.\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": "-o {output file}",
                    "content": "Write output to a file rather than stdout.\n",
                    "flag": "-o"
                },
                {
                    "name": "--metadata-snapshot",
                    "content": "Use the metadata snapshot rather than the current superblock.\n",
                    "long": "--metadata-snapshot"
                },
                {
                    "name": "--written-since {era nr}",
                    "content": "Blocks written since the given era will be listed.\n",
                    "long": "--written-since"
                }
            ]
        },
        "EXAMPLE": {
            "content": "List the blocks that may have been written since the beginning of era 13 on the metadata  de‐\nvice /dev/vg/metadata:\n\n$ erainvalidate --written-since 13 /dev/vg/metadata\n\nThe device may not be actively used by the target when running.\n",
            "subsections": []
        },
        "DIAGNOSTICS": {
            "content": "erainvalidate  returns  an  exit  code of 0 for success or 1 for error (eg, metadata corrup‐\ntion).\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "eracheck(8), eradump(8), erarestore(8)\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "Joe Thornber <ejt@redhat.com>\n\n\n\nSystem Manager's Manual                  Device Mapper Tools                       erainvalidate(8)",
            "subsections": []
        }
    },
    "summary": "erainvalidate - Provide a list of blocks that have changed since a particular era.",
    "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": "-o",
            "long": null,
            "arg": null,
            "description": "Write output to a file rather than stdout."
        },
        {
            "flag": "",
            "long": "--metadata-snapshot",
            "arg": null,
            "description": "Use the metadata snapshot rather than the current superblock."
        },
        {
            "flag": "",
            "long": "--written-since",
            "arg": null,
            "description": "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  de‐",
        "vice /dev/vg/metadata:",
        "$ erainvalidate --written-since 13 /dev/vg/metadata",
        "The device may not be actively used by the target when running."
    ],
    "see_also": [
        {
            "name": "eracheck",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/eracheck/8/json"
        },
        {
            "name": "eradump",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/eradump/8/json"
        },
        {
            "name": "erarestore",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/erarestore/8/json"
        }
    ]
}