cache_repair man page

cache_repair — repair cache binary metadata from device/file to device/file


cache_repair [options] -i {device|file} -o {device|file}


cache_repair reads binary cache metadata created by the respective device-mapper target from one device or file , repairs it and writes it to another device or file. If written to a metadata device , the metadata can be processed by the device-mapper target.

This tool cannot be run on live metadata.

-i, --input {device|file}

Input file or device with binary metadata.

-o, --output {device|file}

Output file or device for repaired binary metadata.  If a file is used then it must be preallocated, and large enough to hold the metadata.

-h, --help

Print help and exit.

-V, --version

Output version information and exit.


Reads the binary cache metadata from file metadata , repairs it and writes it to logical volume /dev/vg/metadata for further processing by the respective device-mapper target:

cache_repair -i metadata -o /dev/vg/metadata


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

See Also

cache_dump(8) cache_check(8) cache_restore(8)


Joe Thornber <>
Heinz Mauelshagen <>

Referenced By

cache_check(8), cache_dump(8), cache_restore(8), cache_writeback(8), lvconvert(8).

Thin Provisioning Tools Red Hat, Inc.