cache_check(8)

1cache_check(8)              System Manager's Manual             cache_check(8)
2
3
4

NAME

6       cache_check - validates cache metadata on a device or file.
7

SYNOPSIS

9       cache_check [options] {device|file}
10
11

DESCRIPTION

13       cache_check  checks  cache  metadata created by the device-mapper cache
14       target on a device or file.
15
16       This tool cannot be run on live metadata.
17

OPTIONS

19       -h, --help
20              Print help and exit.
21
22       -V, --version
23              Output version information and exit.
24
25       -q, --quiet
26              Suppress output messages, return only exit code.
27
28       --super-block-only
29              Only check the superblock.
30
31       --skip-hints
32              Skip checking of the policy hint values metadata.
33
34       --skip-discards
35              Skip checking of the discard bits in the metadata.
36
37       --clear-needs-check-flag
38              Clears the 'needs_check' flag in the superblock.
39
40           The kernel may set a flag to force the pool to be checked before it's next
41           activated.  Set this switch to clear the flag if the check is successful.
42           If the metadata check failed, the flag is not cleared and a cache_repair run
43           is needed to fix any issues. After cache_repair succeeded, you may run
44           cache_check again.
45
46

EXAMPLE

48       Analyses and repairs cache metadata on logical volume /dev/vg/metadata:
49
50           $ cache_check /dev/vg/metadata
51
52       The device may not be actively used by the target when running.
53

DIAGNOSTICS

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

AUTHOR

61       Joe Thornber <ejt@redhat.com>, Heinz Mauelshagen <HeinzM@RedHat.com>
62
63
64
65System Manager's Manual       Device Mapper Tools               cache_check(8)