# Text automatically generated by txt2man

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

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

     SEE ALSO

     Page 1               System Manager's Manual    (printed 5/23/22)

     cache_check(8)        (Device Mapper Tools)        cache_check(8)

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

     AUTHOR
          Joe Thornber <ejt@redhat.com>, Heinz Mauelshagen
          <HeinzM@RedHat.com>

     Page 2               System Manager's Manual    (printed 5/23/22)