2017-09-20 15:45:00 +05:30
|
|
|
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
|
2017-09-20 18:23:59 +05:30
|
|
|
-h, --help Print help and exit.
|
|
|
|
|
-V, --version Output version information and exit.
|
|
|
|
|
-q, --quiet Suppress output messages, return only exit code.
|
2017-09-20 15:45:00 +05:30
|
|
|
--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.
|
2017-09-20 15:45:00 +05:30
|
|
|
|
|
|
|
|
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>
|
|
|
|
|
|
