Back to main site | Back to man page index

THIN_DUMP(8)                                   System Manager's Manual                                   THIN_DUMP(8)



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  analy‐
       sis  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.


       -f, --format {xml|human_readable}
       Print output in XML or human readable format.


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


       -m, --metadata-snap [block#]
       Dump  metadata  snapshot  created by device-mapper thin provisioning target.  If block is not provided, access
       the default metadata snapshot created by the thin provisioning device-mapper  target,  else  try  the  one  at
       block#.   See  the  thin provisioning target documentation on how to create or release a metadata snapshot and
       retrieve the block number from the kernel.


       -h, --help
       Print help and exit.


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


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

       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



Red Hat, Inc.                                  Thin Provisioning Tools                                   THIN_DUMP(8)