{
    "mode": "man",
    "parameter": "cache_dump",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/cache_dump/8/json",
    "generated": "2026-07-13T02:09:02Z",
    "synopsis": "cachedump [options] {device|file}",
    "sections": {
        "NAME": {
            "content": "cachedump - dump cache metadata from device or file to standard output.\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "cachedump [options] {device|file}\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "cachedump  dumps binary cache metadata created by the device-mapper cache target on a device\nor file to standard output for analysis or postprocessing in XML format. XML formatted  meta‐\ndata can be fed into cacherestore in order to put it back onto a metadata device (to process\nby the device-mapper target), or file.\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": "-r, --repair",
                    "content": "Repair the metadata whilst dumping it.\n",
                    "flag": "-r",
                    "long": "--repair"
                },
                {
                    "name": "-o {xml file}",
                    "content": "Specify an output file for the xml, rather than printing to stdout.\n",
                    "flag": "-o"
                }
            ]
        },
        "EXAMPLES": {
            "content": "Dumps the cache metadata on logical volume /dev/vg/metadata to standard output in XML format:\n\n$ cachedump /dev/vg/metadata\n\nDumps the cache metadata on logical volume /dev/vg/metadata whilst repairing it  to  standard\noutput in XML format:\n\n$ cachedump --repair /dev/vg/metadata\n\n",
            "subsections": []
        },
        "DIAGNOSTICS": {
            "content": "cachedump returns an exit code of 0 for success or 1 for error.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "cachecheck(8), cacherepair(8), cacherestore(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                           cachedump(8)",
            "subsections": []
        }
    },
    "summary": "cachedump - dump cache metadata from device or file to standard output.",
    "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": "-r",
            "long": "--repair",
            "arg": null,
            "description": "Repair the metadata whilst dumping it."
        },
        {
            "flag": "-o",
            "long": null,
            "arg": null,
            "description": "Specify an output file for the xml, rather than printing to stdout."
        }
    ],
    "examples": [
        "Dumps the cache metadata on logical volume /dev/vg/metadata to standard output in XML format:",
        "$ cachedump /dev/vg/metadata",
        "Dumps the cache metadata on logical volume /dev/vg/metadata whilst repairing it  to  standard",
        "output in XML format:",
        "$ cachedump --repair /dev/vg/metadata"
    ],
    "see_also": [
        {
            "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"
        },
        {
            "name": "cacherestore",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/cacherestore/8/json"
        }
    ]
}