{
    "content": [
        {
            "type": "text",
            "text": "# thin_dump(8) (man)\n\n**Summary:** thindump - dump thin provisioning metadata from device or file to standard output.\n\n**Synopsis:** thindump [options] {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| -f | --format | — | Choose output format. Custom formats are supported via shared library plugins. They should be specified as in this examp |\n| -r | --repair | — | Repair the metadata whilst dumping it. |\n| -m | — | — | Dump metadata snapshot. If block is not provided, access the default metadata snapshot created by the thin provisioning  |\n| — | --dev-id | — | Dump the specified device. This option may be specified multiple times to select more than one thin device. |\n| — | --transaction-id | — | Override the transaction id given in the input xml. |\n| — | --data-block-size | — | Override the data block size given in the input xml. |\n| — | --nr-data-blocks | — | Override the nr data blocks given in the input xml. |\n| — | --skip-mappings | — | Do not dump the mappings. |\n| -o | — | — | Specify a file for the output rather than writing to stdout. |\n\n## Examples\n\n- `Dumps the thin provisioning metadata on logical volume /dev/vg/metadata to standard output in`\n- `human readable format:`\n- `$ thindump -f humanreadable /dev/vg/metadata`\n- `Dumps the thin provisioning metadata on logical volume /dev/vg/metadata to standard output in`\n- `XML format:`\n- `$ thindump /dev/vg/metadata`\n- `Dumps  the thin provisioning metadata snapshot on logical volume /dev/vg/metadata to standard`\n- `output in human readable format (not processable by thinrestore(8)):`\n- `$ thindump --format humanreadable --metadata-snap /dev/vg/metadata`\n\n## See Also\n\n- thincheck(8)\n- thinrepair(8)\n- thinrestore(8)\n- thinrmap(8)\n- thinmetadatasize(8)\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (2 lines)\n- **DESCRIPTION** (8 lines)\n- **OPTIONS** (1 lines) — 11 subsections\n  - -h, --help (2 lines)\n  - -V, --version (2 lines)\n  - -f, --format (8 lines)\n  - -r, --repair (2 lines)\n  - -m, --metadata-snap{=<block nr>} (8 lines)\n  - --dev-id {natural} (6 lines)\n  - --transaction-id {natural} (2 lines)\n  - --data-block-size {natural} (2 lines)\n  - --nr-data-blocks {natural} (2 lines)\n  - --skip-mappings (2 lines)\n  - -o {xml file} (2 lines)\n- **EXAMPLES** (16 lines)\n- **DIAGNOSTICS** (2 lines)\n- **SEE ALSO** (2 lines)\n- **AUTHOR** (5 lines)\n\n## Full Content\n\n### NAME\n\nthindump - dump thin provisioning metadata from device or file to standard output.\n\n### SYNOPSIS\n\nthindump [options] {device|file}\n\n### DESCRIPTION\n\nthindump  dumps  binary thin provisioning metadata (optionally from alternate block; see op‐\ntion --metadata-snap) created by the device-mapper thin provisioning target on  a  device  or\nfile  to  standard output for analysis or postprocessing in either XML or human readable for‐\nmat.  XML formated metadata can be fed into thinrestore (see thinrestore(8))  in  order  to\nput it back onto a metadata device (to process by the device-mapper target) or file.\n\nThis tool cannot be run on live metadata unless the --metadata-snap option is used.\n\n### OPTIONS\n\n#### -h, --help\n\nPrint help and exit.\n\n#### -V, --version\n\nPrint version information and exit.\n\n#### -f, --format\n\nChoose output format.\n\nCustom formats are supported via shared library plugins.  They should be\nspecified as in this example:\n\n$ thindump --format custom=mylib.so /dev/sda\n\n#### -r, --repair\n\nRepair the metadata whilst dumping it.\n\n#### -m, --metadata-snap{=<block nr>}\n\nDump metadata snapshot.\n\nIf block is not provided, access the default metadata snapshot created by\nthe thin provisioning device-mapper target, else try the one at block nr.\nSee the thin provisioning target documentation on how to create or release\na metadata snapshot and retrieve the block number from the kernel.\n\n#### --dev-id {natural}\n\nDump the specified device.\n\nThis option may be specified multiple times to select more than one thin\ndevice.\n\n#### --transaction-id {natural}\n\nOverride the transaction id given in the input xml.\n\n#### --data-block-size {natural}\n\nOverride the data block size given in the input xml.\n\n#### --nr-data-blocks {natural}\n\nOverride the nr data blocks given in the input xml.\n\n#### --skip-mappings\n\nDo not dump the mappings.\n\n#### -o {xml file}\n\nSpecify a file for the output rather than writing to stdout.\n\n### EXAMPLES\n\nDumps the thin provisioning metadata on logical volume /dev/vg/metadata to standard output in\nhuman readable format:\n\n$ thindump -f humanreadable /dev/vg/metadata\n\nDumps the thin provisioning metadata on logical volume /dev/vg/metadata to standard output in\nXML format:\n\n$ thindump /dev/vg/metadata\n\nDumps  the thin provisioning metadata snapshot on logical volume /dev/vg/metadata to standard\noutput in human readable format (not processable by thinrestore(8)):\n\n$ thindump --format humanreadable --metadata-snap /dev/vg/metadata\n\n### DIAGNOSTICS\n\nthindump returns an exit code of 0 for success or 1 for error.\n\n### SEE ALSO\n\nthincheck(8), thinrepair(8), thinrestore(8), thinrmap(8), thinmetadatasize(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                            thindump(8)\n\n"
        }
    ],
    "structuredContent": {
        "command": "thin_dump",
        "section": "8",
        "mode": "man",
        "summary": "thindump - dump thin provisioning metadata from device or file to standard output.",
        "synopsis": "thindump [options] {device|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": "-f",
                "long": "--format",
                "arg": null,
                "description": "Choose output format. Custom formats are supported via shared library plugins. They should be specified as in this example: $ thindump --format custom=mylib.so /dev/sda"
            },
            {
                "flag": "-r",
                "long": "--repair",
                "arg": null,
                "description": "Repair the metadata whilst dumping it."
            },
            {
                "flag": "-m",
                "long": null,
                "arg": null,
                "description": "Dump metadata snapshot. If block is not provided, access the default metadata snapshot created by the thin provisioning device-mapper target, else try the one at block nr. See the thin provisioning target documentation on how to create or release a metadata snapshot and retrieve the block number from the kernel."
            },
            {
                "flag": "",
                "long": "--dev-id",
                "arg": null,
                "description": "Dump the specified device. This option may be specified multiple times to select more than one thin device."
            },
            {
                "flag": "",
                "long": "--transaction-id",
                "arg": null,
                "description": "Override the transaction id given in the input xml."
            },
            {
                "flag": "",
                "long": "--data-block-size",
                "arg": null,
                "description": "Override the data block size given in the input xml."
            },
            {
                "flag": "",
                "long": "--nr-data-blocks",
                "arg": null,
                "description": "Override the nr data blocks given in the input xml."
            },
            {
                "flag": "",
                "long": "--skip-mappings",
                "arg": null,
                "description": "Do not dump the mappings."
            },
            {
                "flag": "-o",
                "long": null,
                "arg": null,
                "description": "Specify a file for the output rather than writing to stdout."
            }
        ],
        "examples": [
            "Dumps the thin provisioning metadata on logical volume /dev/vg/metadata to standard output in",
            "human readable format:",
            "$ thindump -f humanreadable /dev/vg/metadata",
            "Dumps the thin provisioning metadata on logical volume /dev/vg/metadata to standard output in",
            "XML format:",
            "$ thindump /dev/vg/metadata",
            "Dumps  the thin provisioning metadata snapshot on logical volume /dev/vg/metadata to standard",
            "output in human readable format (not processable by thinrestore(8)):",
            "$ thindump --format humanreadable --metadata-snap /dev/vg/metadata"
        ],
        "see_also": [
            {
                "name": "thincheck",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/thincheck/8/json"
            },
            {
                "name": "thinrepair",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/thinrepair/8/json"
            },
            {
                "name": "thinrestore",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/thinrestore/8/json"
            },
            {
                "name": "thinrmap",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/thinrmap/8/json"
            },
            {
                "name": "thinmetadatasize",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/thinmetadatasize/8/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 8,
                "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": "-f, --format",
                        "lines": 8,
                        "flag": "-f",
                        "long": "--format"
                    },
                    {
                        "name": "-r, --repair",
                        "lines": 2,
                        "flag": "-r",
                        "long": "--repair"
                    },
                    {
                        "name": "-m, --metadata-snap{=<block nr>}",
                        "lines": 8,
                        "flag": "-m"
                    },
                    {
                        "name": "--dev-id {natural}",
                        "lines": 6,
                        "long": "--dev-id"
                    },
                    {
                        "name": "--transaction-id {natural}",
                        "lines": 2,
                        "long": "--transaction-id"
                    },
                    {
                        "name": "--data-block-size {natural}",
                        "lines": 2,
                        "long": "--data-block-size"
                    },
                    {
                        "name": "--nr-data-blocks {natural}",
                        "lines": 2,
                        "long": "--nr-data-blocks"
                    },
                    {
                        "name": "--skip-mappings",
                        "lines": 2,
                        "long": "--skip-mappings"
                    },
                    {
                        "name": "-o {xml file}",
                        "lines": 2,
                        "flag": "-o"
                    }
                ]
            },
            {
                "name": "EXAMPLES",
                "lines": 16,
                "subsections": []
            },
            {
                "name": "DIAGNOSTICS",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "AUTHOR",
                "lines": 5,
                "subsections": []
            }
        ]
    }
}