{
    "content": [
        {
            "type": "text",
            "text": "# cache_restore(8) (man)\n\n**Summary:** cacherestore - restore cache metadata file to device or file.\n\n**Synopsis:** cacherestore [options] -i {xml file} -o {device|file}\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| -h | --help | — | Print help and exit. |\n| -V | --version | — | Print version information and exit. |\n| -q | --quiet | — | Don't print any output. Check the exit code to test for success. |\n| -i | --input | — | Input xml. |\n| -o | --output | — | Output file or device for restored binary metadata. If a file is used thin it must be preallocated, and large enough to  |\n| — | --metadata-version | — | Choose a metadata version. |\n\n## Examples\n\n- `Restores the XML formatted cache metadata on file metadata to logical volume /dev/vg/metadata`\n- `for further processing by the respective device-mapper target:`\n- `$ cacherestore -i metadata -o /dev/vg/metadata`\n\n## See Also\n\n- cachedump(8)\n- cachecheck(8)\n- cacherepair(8)\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (2 lines)\n- **DESCRIPTION** (7 lines)\n- **OPTIONS** (1 lines) — 6 subsections\n  - -h, --help (2 lines)\n  - -V, --version (2 lines)\n  - -q, --quiet (2 lines)\n  - -i, --input {xml file} (2 lines)\n  - -o, --output {device|file} (6 lines)\n  - --metadata-version {1|2} (2 lines)\n- **DEBUGGING OPTIONS** (1 lines) — 2 subsections\n  - --debug-override-metadata-version {integer} (2 lines)\n  - --omit-clean-shutdown (2 lines)\n- **EXAMPLE** (6 lines)\n- **DIAGNOSTICS** (2 lines)\n- **SEE ALSO** (2 lines)\n- **AUTHOR** (5 lines)\n\n## Full Content\n\n### NAME\n\ncacherestore - restore cache metadata file to device or file.\n\n### SYNOPSIS\n\ncacherestore [options] -i {xml file} -o {device|file}\n\n### DESCRIPTION\n\ncacherestore  restores  cache metadata created by the respective device-mapper target dumped\ninto an XML formatted (see cachedump(8)) file, which optionally can be  preprocessed  before\nthe restore 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\n### OPTIONS\n\n#### -h, --help\n\nPrint help and exit.\n\n#### -V, --version\n\nPrint version information and exit.\n\n#### -q, --quiet\n\nDon't print any output.  Check the exit code to test for success.\n\n#### -i, --input {xml file}\n\nInput xml.\n\n#### -o, --output {device|file}\n\nOutput file or device for restored binary metadata.\n\nIf a file is used thin it must be preallocated, and large enough to hold\nthe metadata.\n\n#### --metadata-version {1|2}\n\nChoose a metadata version.\n\n### DEBUGGING OPTIONS\n\n#### --debug-override-metadata-version {integer}\n\nOverride the version stored in the metadata.\n\n#### --omit-clean-shutdown\n\nDon't set the clean shutdown flag.\n\n### EXAMPLE\n\nRestores the XML formatted cache metadata on file metadata to logical volume /dev/vg/metadata\nfor further processing by the respective device-mapper target:\n\n$ cacherestore -i metadata -o /dev/vg/metadata\n\n### DIAGNOSTICS\n\ncacherestore returns an exit code of 0 for success or 1 for error.\n\n### SEE ALSO\n\ncachedump(8), cachecheck(8), cacherepair(8)\n\n### AUTHOR\n\nJoe Thornber <ejt@redhat.com>, Heinz Mauelshagen <HeinzM@RedHat.com>\n\n\n\nSystem Manager's Manual                  Device Mapper Tools                        cacherestore(8)\n\n"
        }
    ],
    "structuredContent": {
        "command": "cache_restore",
        "section": "8",
        "mode": "man",
        "summary": "cacherestore - restore cache metadata file to device or file.",
        "synopsis": "cacherestore [options] -i {xml file} -o {device|file}",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "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": "Input xml."
            },
            {
                "flag": "-o",
                "long": "--output",
                "arg": null,
                "description": "Output file or device for restored binary metadata. If a file is used thin it must be preallocated, and large enough to hold the metadata."
            },
            {
                "flag": "",
                "long": "--metadata-version",
                "arg": null,
                "description": "Choose a metadata version."
            }
        ],
        "examples": [
            "Restores the XML formatted cache metadata on file metadata to logical volume /dev/vg/metadata",
            "for further processing by the respective device-mapper target:",
            "$ cacherestore -i metadata -o /dev/vg/metadata"
        ],
        "see_also": [
            {
                "name": "cachedump",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/cachedump/8/json"
            },
            {
                "name": "cachecheck",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/cachecheck/8/json"
            },
            {
                "name": "cacherepair",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/cacherepair/8/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 7,
                "subsections": []
            },
            {
                "name": "OPTIONS",
                "lines": 1,
                "subsections": [
                    {
                        "name": "-h, --help",
                        "lines": 2,
                        "flag": "-h",
                        "long": "--help"
                    },
                    {
                        "name": "-V, --version",
                        "lines": 2,
                        "flag": "-V",
                        "long": "--version"
                    },
                    {
                        "name": "-q, --quiet",
                        "lines": 2,
                        "flag": "-q",
                        "long": "--quiet"
                    },
                    {
                        "name": "-i, --input {xml file}",
                        "lines": 2,
                        "flag": "-i",
                        "long": "--input"
                    },
                    {
                        "name": "-o, --output {device|file}",
                        "lines": 6,
                        "flag": "-o",
                        "long": "--output"
                    },
                    {
                        "name": "--metadata-version {1|2}",
                        "lines": 2,
                        "long": "--metadata-version"
                    }
                ]
            },
            {
                "name": "DEBUGGING OPTIONS",
                "lines": 1,
                "subsections": [
                    {
                        "name": "--debug-override-metadata-version {integer}",
                        "lines": 2,
                        "long": "--debug-override-metadata-version"
                    },
                    {
                        "name": "--omit-clean-shutdown",
                        "lines": 2,
                        "long": "--omit-clean-shutdown"
                    }
                ]
            },
            {
                "name": "EXAMPLE",
                "lines": 6,
                "subsections": []
            },
            {
                "name": "DIAGNOSTICS",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "AUTHOR",
                "lines": 5,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "cacherestore - restore cache metadata file to device or file.\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "cacherestore [options] -i {xml file} -o {device|file}\n",
                "subsections": []
            },
            "DESCRIPTION": {
                "content": "cacherestore  restores  cache metadata created by the respective device-mapper target dumped\ninto an XML formatted (see cachedump(8)) file, which optionally can be  preprocessed  before\nthe restore 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": "Input xml.\n",
                        "flag": "-i",
                        "long": "--input"
                    },
                    {
                        "name": "-o, --output {device|file}",
                        "content": "Output file or device for restored binary metadata.\n\nIf a file is used thin it must be preallocated, and large enough to hold\nthe metadata.\n\n",
                        "flag": "-o",
                        "long": "--output"
                    },
                    {
                        "name": "--metadata-version {1|2}",
                        "content": "Choose a metadata version.\n",
                        "long": "--metadata-version"
                    }
                ]
            },
            "DEBUGGING OPTIONS": {
                "content": "",
                "subsections": [
                    {
                        "name": "--debug-override-metadata-version {integer}",
                        "content": "Override the version stored in the metadata.\n",
                        "long": "--debug-override-metadata-version"
                    },
                    {
                        "name": "--omit-clean-shutdown",
                        "content": "Don't set the clean shutdown flag.\n",
                        "long": "--omit-clean-shutdown"
                    }
                ]
            },
            "EXAMPLE": {
                "content": "Restores the XML formatted cache metadata on file metadata to logical volume /dev/vg/metadata\nfor further processing by the respective device-mapper target:\n\n$ cacherestore -i metadata -o /dev/vg/metadata\n\n",
                "subsections": []
            },
            "DIAGNOSTICS": {
                "content": "cacherestore returns an exit code of 0 for success or 1 for error.\n",
                "subsections": []
            },
            "SEE ALSO": {
                "content": "cachedump(8), cachecheck(8), cacherepair(8)\n",
                "subsections": []
            },
            "AUTHOR": {
                "content": "Joe Thornber <ejt@redhat.com>, Heinz Mauelshagen <HeinzM@RedHat.com>\n\n\n\nSystem Manager's Manual                  Device Mapper Tools                        cacherestore(8)",
                "subsections": []
            }
        }
    }
}