thin_check(8)

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

NAME

6       thin_check - validate thin provisioning metadata on device or file
7
8

SYNOPSIS

10       thin_check [options] {device|file}
11
12

DESCRIPTION

14       thin_check checks thin provisioning metadata created by the device-map‐
15       per thin provisioning target on a device or file.
16
17       This tool cannot be run on live metadata.
18
19

OPTIONS

21       -q, --quiet
22              Suppress output messages, return only exit code.
23
24
25       -h, --help
26              Print help and exit.
27
28
29       -V, --version
30              Output version information and exit.
31
32
33       --clear-needs-check-flag
34              Clear the needs-check-flag in case the check of  the  thin  pool
35              metadata  succeeded.   If the metadata check failed, the flag is
36              not cleared and a thin_repair run is needed to fix  any  issues.
37              After thin_repair succeeded, you may run thin_check again.
38
39
40       --super-block-only
41              Only check the superblock is present.
42
43
44       --skip-mappings
45              Skip  checking  of  the block mappings which make up the bulk of
46              the metadata.
47
48
49       --ignore-non-fatal-errors
50              thin_check will only return a non-zero exit code if it  finds  a
51              fatal  error.   An  example of a non fatal error is an incorrect
52              data block reference count causing  a  block  to  be  considered
53              allocated  when  it  in  fact isn't.  Ignoring errors for a long
54              time is not advised, you really should be using  thin_repair  to
55              fix them.
56
57

EXAMPLE

59       Analyses thin provisioning metadata on logical volume /dev/vg/metadata:
60
61       thin_check /dev/vg/metadata
62
63       The device must not be actively used by the target when running.
64
65

DIAGNOSTICS

67       thin_check returns an exit code of 0 for success or 1 for error.
68
69

AUTHOR

76       Joe Thornber <ejt@redhat.com>
77       Heinz Mauelshagen <HeinzM@RedHat.com>
78
79
80
81Red Hat, Inc.               Thin Provisioning Tools              THIN_CHECK(8)