# Text automatically generated by txt2man

     NAME
          thin_dump - dump thin provisioning metadata from device or
          file to standard output.

     SYNOPSIS
          thin_dump [options] {device|file}

     DESCRIPTION
          thin_dump dumps binary thin provisioning metadata
          (optionally from alternate block; see option --metadata-
          snap) created by the device-mapper thin provisioning target
          on a device or file to standard output for analysis or
          postprocessing in either XML or human readable format.  XML
          formated metadata can be fed into thin_restore (see
          thin_restore(8)) in order to put it back onto a metadata
          device (to process by the device-mapper target) or file.

          This tool cannot be run on live metadata unless the --
          metadata-snap option is used.

     OPTIONS
          -h, --help
               Print help and exit.

          -V, --version
               Print version information and exit.

          -f, --format {xml|human_readable|custom}
               Choose output format.

              Custom formats are supported via shared library plugins.  They should be
              specified as in this example:

                $ thin_dump --format custom=mylib.so /dev/sda

          -r, --repair
               Repair the metadata whilst dumping it.

          -m, --metadata-snap{=<block nr>}
               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.

          --dev-id {natural}
               Dump the specified device.

              This option may be specified multiple times to select more than one thin
              device.

     Page 1               System Manager's Manual    (printed 5/23/22)

     thin_dump(8)          (Device Mapper Tools)          thin_dump(8)

          --transaction-id {natural}
               Override the transaction id given in the input xml.

          --data-block-size {natural}
               Override the data block size given in the input xml.

          --nr-data-blocks {natural}
               Override the nr data blocks given in the input xml.

          --skip-mappings
               Do not dump the mappings.

          -o {xml file}
               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 for-
          mat:

              $ thin_dump -f human_readable /dev/vg/metadata

          Dumps the thin provisioning metadata on logical volume
          /dev/vg/metadata to standard output in XML format:

              $ thin_dump /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 thin_restore(8)):

              $ thin_dump --format human_readable --metadata-snap /dev/vg/metadata

     DIAGNOSTICS
          thin_dump returns an exit code of 0 for success or 1 for
          error.

     SEE ALSO
          thin_check(8), thin_repair(8), thin_restore(8),
          thin_rmap(8), thin_metadata_size(8)

     AUTHOR
          Joe Thornber <ejt@redhat.com>, Heinz Mauelshagen
          <HeinzM@RedHat.com>

     Page 2               System Manager's Manual    (printed 5/23/22)