cache_check man page

cache_check — repair cache metadata on device or file


cache_check [options] {device|file}


cache_check checks cache  metadata created by the device-mapper cache target on a device or file.

This tool cannot be run on live metadata.


-q, --quiet

Suppress output messages, return only exit code.

-h, --help

Print help and exit.

-V, --version

Output version information and exit.


Only check the superblock is present.


Skip checking of the block mappings which make up the bulk of the metadata.


Skip checking of the policy hint values metadata.


Skip checking of the discard bits in the metadata.


Analyses and repairs cache metadata on logical volume /dev/vg/metadata:

cache_check /dev/vg/metadata

The device may not be actively used by the target when running.


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

See Also

cache_dump(8) cache_repair(8) cache_restore(8)


Joe Thornber <>
Heinz Mauelshagen <>

Referenced By

cache_dump(8), cache_repair(8), cache_restore(8), cache_writeback(8).

Thin Provisioning Tools Red Hat, Inc.