Back to main site | Back to man page index

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



NAME
       cache_dump - dump cache metadata from device or file to standard output


SYNOPSIS
       cache_dump [options] {device|file}


DESCRIPTION
       cache_dump  dumps binary cache metadata created by the device-mapper cache target on a device or file to stan‐
       dard output for analysis or postprocessing in XML format.  XML formated metadata can be fed into cache_restore
       (see cache_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.


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


       -h, --help
       Print help and exit.


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


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

       cache_dump /dev/vg/metadata


EXAMPLES
       Dumps the cache metadata on logical volume /dev/vg/metadata whilst repairing it to standard output in XML for‐
       mat:

       cache_dump --repair /dev/vg/metadata


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


SEE ALSO
       cache_check(8) cache_repair(8) cache_restore(8)


AUTHOR
       Joe Thornber <[email protected]>
       Heinz Mauelshagen <[email protected]>