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.
    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>

