thin-provisioning-tools/man8/cache_check.txt

44 lines
1.4 KiB
Plaintext
Raw Normal View History

NAME
cache_check - validates cache metadata on a device or file.
SYNOPSIS
cache_check [options] {device|file}
DESCRIPTION
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.
OPTIONS
-h, --help Print help and exit.
-V, --version Output version information and exit.
-q, --quiet Suppress output messages, return only exit code.
--super-block-only Only check the superblock.
--skip-hints Skip checking of the policy hint values metadata.
--skip-discards Skip checking of the discard bits in the metadata.
--clear-needs-check-flag Clears the 'needs_check' flag in the superblock.
The kernel may set a flag to force the pool to be checked before it's next
activated. Set this switch to clear the flag if the check is successful.
2017-09-21 17:44:20 +05:30
If the metadata check failed, the flag is not cleared and a cache_repair run
is needed to fix any issues. After cache_repair succeeded, you may run
cache_check again.
EXAMPLE
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.
DIAGNOSTICS
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)
AUTHOR
Joe Thornber <ejt@redhat.com>, Heinz Mauelshagen <HeinzM@RedHat.com>