vgck(8) - f33

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
100              unusual error messages in multi-stage operations if a tool
101              relies on reading back metadata it believes has changed but
102              hasn't.
103
104       --updatemetadata
105              Update VG metadata to correct problems.  If VG metadata was
106              updated while a PV was missing, and the PV reappears with an old
107              version of metadata, then this option (or any other command that
108              writes metadata) will update the metadata on the previously
109              missing PV. If a PV was removed from a VG while it was missing,
110              and the PV reappears, using this option will clear the outdated
111              metadata from the previously missing PV. If metadata text is
112              damaged on one PV, using this option will replace the damaged
113              metadata text. For more severe damage, e.g. with headers, see
114              pvck(8).
115
116       -v|--verbose ...
117              Set verbose level. Repeat from 1 to 4 times to increase the
118              detail of messages sent to stdout and stderr.
119
120       --version
121              Display version information.
122
123       -y|--yes
124              Do not prompt for confirmation interactively but always assume
125              the answer yes. Use with extreme caution.  (For automatic no,
126              see -qq.)
127

VARIABLES

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

ENVIRONMENT VARIABLES

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