vgck(8) - f37

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

NAME

6       vgck - Check the consistency of volume group(s)
7

SYNOPSIS

9       vgck option_args position_args
10           [ option_args ]
11           [ position_args ]
12

DESCRIPTION

14       vgck checks LVM metadata for consistency.
15

USAGE

17       Read and display information about a VG.
18
19       vgck
20           [    --reportformat basic|json ]
21           [ COMMON_OPTIONS ]
22           [ VG|Tag ... ]
23
24       Rewrite VG metadata to correct problems.
25
26       vgck --updatemetadata VG
27           [ COMMON_OPTIONS ]
28
29       Common options for command:
30
31       Common options for lvm:
32           [ -d|--debug ]
33           [ -h|--help ]
34           [ -q|--quiet ]
35           [ -t|--test ]
36           [ -v|--verbose ]
37           [ -y|--yes ]
38           [    --commandprofile String ]
39           [    --config String ]
40           [    --driverloaded y|n ]
41           [    --lockopt String ]
42           [    --longhelp ]
43           [    --nolocking ]
44           [    --profile String ]
45           [    --version ]
46

OPTIONS

48       --commandprofile String
49              The command profile to use for command configuration.  See
50              lvm.conf(5) for more information about profiles.
51
52       --config String
53              Config settings for the command. These override lvm.conf set‐
54              tings.  The String arg uses the same format as lvm.conf, or may
55              use section/field syntax.  See lvm.conf(5) for more information
56              about config.
57
58       -d|--debug ...
59              Set debug level. Repeat from 1 to 6 times to increase the detail
60              of messages sent to the log file and/or syslog (if configured).
61
62       --driverloaded y|n
63              If set to no, the command will not attempt to use device-mapper.
64              For testing and debugging.
65
66       -h|--help
67              Display help text.
68
69       --lockopt String
70              Used to pass options for special cases to lvmlockd.  See lvm‐
71              lockd(8) for more information.
72
73       --longhelp
74              Display long help text.
75
76       --nolocking
77              Disable locking.
78
79       --profile String
80              An alias for --commandprofile or --metadataprofile, depending on
81              the command.
82
83       -q|--quiet ...
84              Suppress output and log messages. Overrides --debug and --ver‐
85              bose.  Repeat once to also suppress any prompts with answer
86              'no'.
87
88       --reportformat basic|json
89              Overrides current output format for reports which is defined
90              globally by the report/output_format setting in lvm.conf.  basic
91              is the original format with columns and rows.  If there is more
92              than one report per command, each report is prefixed with the
93              report name for identification. json produces report output in
94              JSON format. See lvmreport(7) for more information.
95
96       -t|--test
97              Run in test mode. Commands will not update metadata.  This is
98              implemented by disabling all metadata writing but nevertheless
99              returning success to the calling function. This may lead to un‐
100              usual error messages in multi-stage operations if a tool relies
101              on reading back metadata it believes has changed but hasn't.
102
103       --updatemetadata
104              Update VG metadata to correct problems.  If VG metadata was up‐
105              dated while a PV was missing, and the PV reappears with an old
106              version of metadata, then this option (or any other command that
107              writes metadata) will update the metadata on the previously
108              missing PV. If a PV was removed from a VG while it was missing,
109              and the PV reappears, using this option will clear the outdated
110              metadata from the previously missing PV. If metadata text is
111              damaged on one PV, using this option will replace the damaged
112              metadata text. For more severe damage, e.g. with headers, see
113              pvck(8).
114
115       -v|--verbose ...
116              Set verbose level. Repeat from 1 to 4 times to increase the de‐
117              tail of messages sent to stdout and stderr.
118
119       --version
120              Display version information.
121
122       -y|--yes
123              Do not prompt for confirmation interactively but always assume
124              the answer yes. Use with extreme caution.  (For automatic no,
125              see -qq.)
126

VARIABLES

128       VG
129              Volume Group name.  See lvm(8) for valid names.
130
131       Tag
132              Tag name.  See lvm(8) for information about tag names and  using
133              tags in place of a VG, LV or PV.
134
135       String
136              See the option description for information about the string con‐
137              tent.
138
139       Size[UNIT]
140              Size is an input number that accepts an  optional  unit.   Input
141              units are always treated as base two values, regardless of capi‐
142              talization, e.g. 'k' and 'K' both refer to  1024.   The  default
143              input unit is specified by letter, followed by |UNIT.  UNIT rep‐
144              resents other possible input units:  bBsSkKmMgGtTpPeE.   b|B  is
145              bytes,  s|S is sectors of 512 bytes, k|K is KiB, m|M is MiB, g|G
146              is GiB, t|T is TiB, p|P is PiB, e|E is EiB.  (This should not be
147              confused  with the output control --units, where capital letters
148              mean multiple of 1000.)
149

ENVIRONMENT VARIABLES

151       See lvm(8) for information about environment  variables  used  by  lvm.
152       For example, LVM_VG_NAME can generally be substituted for a required VG
153       parameter.
154