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

NAME

6       vgs - Display information about volume groups
7

SYNOPSIS

9       vgs
10           [ option_args ]
11           [ position_args ]
12

DESCRIPTION

14       vgs produces formatted output about VGs.
15

USAGE

17       vgs
18           [ -a|--all ]
19           [ -o|--options String ]
20           [ -S|--select String ]
21           [ -O|--sort String ]
22           [    --aligned ]
23           [    --binary ]
24           [    --configreport log|vg|lv|pv|pvseg|seg ]
25           [    --foreign ]
26           [    --ignorelockingfailure ]
27           [    --logonly ]
28           [    --nameprefixes ]
29           [    --noheadings ]
30           [    --nosuffix ]
31           [    --readonly ]
32           [    --reportformat basic|json ]
33           [    --rows ]
34           [    --separator String ]
35           [    --shared ]
36           [    --unbuffered ]
37           [    --units r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E ]
38           [    --unquoted ]
39           [ COMMON_OPTIONS ]
40           [ VG|Tag ... ]
41
42       Common options for lvm:
43           [ -d|--debug ]
44           [ -h|--help ]
45           [ -q|--quiet ]
46           [ -t|--test ]
47           [ -v|--verbose ]
48           [ -y|--yes ]
49           [    --commandprofile String ]
50           [    --config String ]
51           [    --driverloaded y|n ]
52           [    --lockopt String ]
53           [    --longhelp ]
54           [    --nolocking ]
55           [    --profile String ]
56           [    --version ]
57

OPTIONS

59       --aligned
60              Use with --separator to align the output columns
61
62       -a|--all
63              List all VGs. Equivalent to not specifying any VGs.
64
65       --binary
66              Use binary values "0" or "1" instead of descriptive literal val‐
67              ues for columns that have exactly two valid values to report
68              (not counting the "unknown" value which denotes that the value
69              could not be determined).
70
71       --commandprofile String
72              The command profile to use for command configuration.  See
73              lvm.conf(5) for more information about profiles.
74
75       --config String
76              Config settings for the command. These override lvm.conf set‐
77              tings.  The String arg uses the same format as lvm.conf, or may
78              use section/field syntax.  See lvm.conf(5) for more information
79              about config.
80
81       --configreport log|vg|lv|pv|pvseg|seg
82              See lvmreport(7).
83
84       -d|--debug ...
85              Set debug level. Repeat from 1 to 6 times to increase the detail
86              of messages sent to the log file and/or syslog (if configured).
87
88       --driverloaded y|n
89              If set to no, the command will not attempt to use device-mapper.
90              For testing and debugging.
91
92       --foreign
93              Report/display foreign VGs that would otherwise be skipped.  See
94              lvmsystemid(7) for more information about foreign VGs.
95
96       -h|--help
97              Display help text.
98
99       --ignorelockingfailure
100              Allows a command to continue with read-only metadata operations
101              after locking failures.
102
103       --lockopt String
104              Used to pass options for special cases to lvmlockd.  See lvm‐
105              lockd(8) for more information.
106
107       --logonly
108              Suppress command report and display only log report.
109
110       --longhelp
111              Display long help text.
112
113       --nameprefixes
114              Add an "LVM2_" prefix plus the field name to the output. Useful
115              with --noheadings to produce a list of field=value pairs that
116              can be used to set environment variables (for example, in udev
117              rules).
118
119       --noheadings
120              Suppress the headings line that is normally the first line of
121              output.  Useful if grepping the output.
122
123       --nolocking
124              Disable locking.
125
126       --nosuffix
127              Suppress the suffix on output sizes. Use with --units (except h
128              and H) if processing the output.
129
130       -o|--options String
131              Comma-separated, ordered list of fields to display in columns.
132              String arg syntax is: [+|-|#]Field1[,Field2 ...]  The prefix +
133              will append the specified fields to the default fields, - will
134              remove the specified fields from the default fields, and # will
135              compact specified fields (removing them when empty for all
136              rows.)  Use -o help to view the list of all available fields.
137              Use separate lists of fields to add, remove or compact by
138              repeating the -o option: -o+field1,field2 -o-field3,field4
139              -o#field5.  These lists are evaluated from left to right.  Use
140              field name lv_all to view all LV fields, vg_all all VG fields,
141              pv_all all PV fields, pvseg_all all PV segment fields, seg_all
142              all LV segment fields, and pvseg_all all PV segment columns.
143              See the lvm.conf report section for more config options.  See
144              lvmreport(7) for more information about reporting.
145
146       --profile String
147              An alias for --commandprofile or --metadataprofile, depending on
148              the command.
149
150       -q|--quiet ...
151              Suppress output and log messages. Overrides --debug and --ver‐
152              bose.  Repeat once to also suppress any prompts with answer
153              'no'.
154
155       --readonly
156              Run the command in a special read-only mode which will read on-
157              disk metadata without needing to take any locks. This can be
158              used to peek inside metadata used by a virtual machine image
159              while the virtual machine is running. No attempt will be made to
160              communicate with the device-mapper kernel driver, so this option
161              is unable to report whether or not LVs are actually in use.
162
163       --reportformat basic|json
164              Overrides current output format for reports which is defined
165              globally by the report/output_format setting in lvm.conf.  basic
166              is the original format with columns and rows.  If there is more
167              than one report per command, each report is prefixed with the
168              report name for identification. json produces report output in
169              JSON format. See lvmreport(7) for more information.
170
171       --rows
172              Output columns as rows.
173
174       -S|--select String
175              Select objects for processing and reporting based on specified
176              criteria.  The criteria syntax is described by --select help and
177              lvmreport(7).  For reporting commands, one row is displayed for
178              each object matching the criteria.  See --options help for
179              selectable object fields.  Rows can be displayed with an addi‐
180              tional "selected" field (-o selected) showing 1 if the row
181              matches the selection and 0 otherwise.  For non-reporting com‐
182              mands which process LVM entities, the selection is used to
183              choose items to process.
184
185       --separator String
186              String to use to separate each column. Useful if grepping the
187              output.
188
189       --shared
190              Report/display shared VGs that would otherwise be skipped when
191              lvmlockd is not being used on the host.  See lvmlockd(8) for
192              more information about shared VGs.
193
194       -O|--sort String
195              Comma-separated ordered list of columns to sort by. Replaces the
196              default selection. Precede any column with - for a reverse sort
197              on that column.
198
199       -t|--test
200              Run in test mode. Commands will not update metadata.  This is
201              implemented by disabling all metadata writing but nevertheless
202              returning success to the calling function. This may lead to
203              unusual error messages in multi-stage operations if a tool
204              relies on reading back metadata it believes has changed but
205              hasn't.
206
207       --unbuffered
208              Produce output immediately without sorting or aligning the col‐
209              umns properly.
210
211       --units r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E
212              All sizes are output in these units: human-(r)eadable with '<'
213              rounding indicator, (h)uman-readable, (b)ytes, (s)ectors,
214              (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes,
215              (e)xabytes.  Capitalise to use multiples of 1000 (S.I.) instead
216              of 1024.  Custom units can be specified, e.g. --units 3M.
217
218       --unquoted
219              When used with --nameprefixes, output values in the field=value
220              pairs are not quoted.
221
222       -v|--verbose ...
223              Set verbose level. Repeat from 1 to 4 times to increase the
224              detail of messages sent to stdout and stderr.
225
226       --version
227              Display version information.
228
229       -y|--yes
230              Do not prompt for confirmation interactively but always assume
231              the answer yes. Use with extreme caution.  (For automatic no,
232              see -qq.)
233

VARIABLES

235       VG
236              Volume Group name.  See lvm(8) for valid names.
237
238       Tag
239              Tag  name.  See lvm(8) for information about tag names and using
240              tags in place of a VG, LV or PV.
241
242       String
243              See the option description for information about the string con‐
244              tent.
245
246       Size[UNIT]
247              Size  is  an  input number that accepts an optional unit.  Input
248              units are always treated as base two values, regardless of capi‐
249              talization,  e.g.  'k'  and 'K' both refer to 1024.  The default
250              input unit is specified by letter, followed by |UNIT.  UNIT rep‐
251              resents  other  possible  input units: bBsSkKmMgGtTpPeE.  b|B is
252              bytes, s|S is sectors of 512 bytes, k|K  is  kilobytes,  m|M  is
253              megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes,
254              e|E is exabytes.  (This should not be confused with  the  output
255              control --units, where capital letters mean multiple of 1000.)
256

ENVIRONMENT VARIABLES

258       See  lvm(8)  for  information  about environment variables used by lvm.
259       For example, LVM_VG_NAME can generally be substituted for a required VG
260       parameter.
261

NOTES

263       The vg_attr bits are:
264
265       1  Permissions: (w)riteable, (r)ead-only
266
267       2  Resi(z)eable
268
269       3  E(x)ported
270
271       4  (p)artial:  one  or  more  physical  volumes belonging to the volume
272          group are missing from the system
273
274       5  Allocation policy: (c)ontiguous, c(l)ing, (n)ormal, (a)nywhere
275
276       6  (c)lustered, (s)hared
277

SEE ALSO

279       lvm(8) lvm.conf(5) lvmconfig(8)
280
281       pvchange(8)  pvck(8)  pvcreate(8)  pvdisplay(8)  pvmove(8)  pvremove(8)
282       pvresize(8) pvs(8) pvscan(8)
283
284       vgcfgbackup(8)  vgcfgrestore(8)  vgchange(8) vgck(8) vgcreate(8) vgcon‐
285       vert(8)  vgdisplay(8)  vgexport(8)  vgextend(8)  vgimport(8)  vgimport‐
286       clone(8)  vgmerge(8)  vgmknodes(8)  vgreduce(8) vgremove(8) vgrename(8)
287       vgs(8) vgscan(8) vgsplit(8)
288
289       lvcreate(8) lvchange(8)  lvconvert(8)  lvdisplay(8)  lvextend(8)  lvre‐
290       duce(8) lvremove(8) lvrename(8) lvresize(8) lvs(8) lvscan(8)
291
292       lvm-fullreport(8) lvm-lvpoll(8) lvm2-activation-generator(8) blkdeacti‐
293       vate(8) lvmdump(8)
294
295       dmeventd(8) lvmpolld(8)  lvmlockd(8)  lvmlockctl(8)  cmirrord(8)  lvmd‐
296       busd(8)
297
298       lvmsystemid(7) lvmreport(7) lvmraid(7) lvmthin(7) lvmcache(7)
299
300
301
302Red Hat, Inc.          LVM TOOLS 2.03.10(2) (2020-08-09)                VGS(8)
Impressum