vgs(8) - c6

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

NAME

6       vgs — report information about volume groups
7

SYNOPSIS

9       vgs  [-a|--all]  [--aligned]  [--binary] [--commandprofile ProfileName]
10       [-d|--debug] [-h|-?|--help] [--ignorelockingfailure]  [--ignoreskipped‐
11       cluster]  [--nameprefixes]  [--noheadings]  [--nosuffix]  [-o|--options
12       [+|-|#]Field1[,Field2...]]     [-O|--sort     [+|-]Key1[,[+|-]Key2...]]
13       [-P|--partial] [--rows] [-S|--select Selection] [--separator Separator]
14       [--unbuffered] [--units hHbBsSkKmMgGtTpPeE] [--unquoted] [-v|--verbose]
15       [--version] [VolumeGroupName [VolumeGroupName...]]
16

DESCRIPTION

18       vgs produces formatted output about volume groups.
19

OPTIONS

21       See lvm(8) for common options.
22
23       --all  List all volume groups.  Equivalent to not specifying any volume
24              groups.
25
26       --aligned
27              Use with --separator to align the output columns.
28
29       --binary
30              Use binary values "0" or "1" instead of descriptive literal val‐
31              ues  for  columns  that  have exactly two valid values to report
32              (not counting the "unknown" value which denotes that  the  value
33              could not be determined).
34
35       --nameprefixes
36              Add an "LVM2_" prefix plus the field name to the output.  Useful
37              with --noheadings to produce a list of  field=value  pairs  that
38              can  be  used  to  set  environment  variables  (for example, in
39              udev(7) rules).
40
41       --noheadings
42              Suppress the headings line that is normally the  first  line  of
43              output.  Useful if grepping the output.
44
45       --nosuffix
46              Suppress the suffix on output sizes.  Use with --units (except h
47              and H) if processing the output.
48
49       -o, --options
50              Comma-separated ordered list of columns.
51
52              Precede the list with '+' to append to the current list of  col‐
53              umns,  '-'  to remove from the current list of columns or '#' to
54              compact given columns. The -o option can be repeated,  providing
55              several lists. These lists are evaluated from left to right.
56
57              Use -o vg_all to select all volume group columns.
58
59              Use -o help to view the full list of columns available.
60
61              Column   names   include:  vg_fmt,  vg_uuid,  vg_name,  vg_attr,
62              vg_size,  vg_free,  vg_sysid,  vg_extent_size,  vg_extent_count,
63              vg_free_count,  vg_profile,  max_lv, max_pv, pv_count, lv_count,
64              snap_count, vg_seqno, vg_tags,  vg_mda_count,  vg_mda_free,  and
65              vg_mda_size, vg_mda_used_count.
66
67              Any  "vg_"  prefixes  are optional.  Columns mentioned in either
68              pvs(8) or lvs(8) can also be chosen, but columns cannot be taken
69              from both at the same time.
70
71              The vg_attr bits are:
72
73              1  Permissions: (w)riteable, (r)ead-only
74
75              2  Resi(z)eable
76
77              3  E(x)ported
78
79              4  (p)artial: one or more physical volumes belonging to the vol‐
80                 ume group are missing from the system
81
82              5  Allocation   policy:   (c)ontiguous,    c(l)ing,    (n)ormal,
83                 (a)nywhere
84
85              6  (c)lustered, (s)hared
86
87       -O, --sort
88              Comma-separated  ordered  list  of columns to sort by.  Replaces
89              the default selection. Precede any column with '-' for a reverse
90              sort on that column.
91
92       --rows Output columns as rows.
93
94       -S, --select Selection
95              Display  only  rows  that match Selection criteria. All rows are
96              displayed with the additional "selected"  column  (-o  selected)
97              showing  1 if the row matches the Selection and 0 otherwise. The
98              Selection criteria are defined by specifying  column  names  and
99              their valid values (that can include reserved values) while mak‐
100              ing use of supported comparison operators. See  lvm(8)  and  -S,
101              --select  description  for  more detailed information about con‐
102              structing the Selection criteria. As a quick  help  and  to  see
103              full  list of column names that can be used in Selection includ‐
104              ing the list of reserved values and the set of supported  selec‐
105              tion operators, check the output of vgs -S help command.
106
107       --separator Separator
108              String  to  use to separate each column.  Useful if grepping the
109              output.
110
111       --unbuffered
112              Produce output immediately without sorting or aligning the  col‐
113              umns properly.
114
115       --units hHbBsSkKmMgGtTpPeE
116              All  sizes are output in these units: (h)uman-readable, (b)ytes,
117              (s)ectors, (k)ilobytes, (m)egabytes,  (g)igabytes,  (t)erabytes,
118              (p)etabytes,  (e)xabytes.   Capitalise  to use multiples of 1000
119              (S.I.) instead of 1024.  Can  also  specify  custom  units  e.g.
120              --units 3M
121
122       --unquoted
123              When  used with --nameprefixes, output values in the field=value
124              pairs are not quoted.
125

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

SEE ALSO