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] [-d|--debug] [-h|-?|--help] [--ignorelock‐
10       ingfailure] [--nameprefixes] [--noheadings] [--nosuffix]  [-o|--options
11       [+]Field[,Field]]  [-O|--sort  [+|-]Key1[,[+|-]Key2[,...]]]  [-P|--par‐
12       tial] [--rows] [--separator Separator]  [--unbuffered]  [--units  hHbB‐
13       sSkKmMgGtTpPeE]  [--unquoted]  [-v|--verbose] [--version] [VolumeGroup‐
14       Name [VolumeGroupName...]]
15

DESCRIPTION

17       vgs produces formatted output about volume groups.
18

OPTIONS

20       See lvm for common options.
21
22       --all  List all volume groups.  Equivalent to not specifying any volume
23              groups.
24
25       --aligned
26              Use with --separator to align the output columns.
27
28       --nameprefixes
29              Add an "LVM2_" prefix plus the field name to the output.  Useful
30              with --noheadings to produce a list of  field=value  pairs  that
31              can  be  used to set environment variables (for example, in udev
32              (7) rules).
33
34       --noheadings
35              Suppress the headings line that is normally the  first  line  of
36              output.  Useful if grepping the output.
37
38       --nosuffix
39              Suppress the suffix on output sizes.  Use with --units (except h
40              and H) if processing the output.
41
42       -o, --options
43              Comma-separated ordered list of columns.  Precede the list  with
44              '+' to append to the default selection of columns.
45
46              Use -o vg_all to select all volume group columns.
47
48              Use -o help to view the full list of columns available.
49
50              Column   names   include:  vg_fmt,  vg_uuid,  vg_name,  vg_attr,
51              vg_size,  vg_free,  vg_sysid,  vg_extent_size,  vg_extent_count,
52              vg_free_count,  max_lv,  max_pv, pv_count, lv_count, snap_count,
53              vg_seqno, vg_tags, vg_mda_count, vg_mda_free,  and  vg_mda_size,
54              vg_mda_used_count.
55
56              Any  "vg_"  prefixes  are optional.  Columns mentioned in either
57              pvs (8) or lvs (8) can also be chosen,  but  columns  cannot  be
58              taken from both at the same time.
59
60              The vg_attr bits are:
61
62              1  Permissions: (w)riteable, (r)ead-only
63
64              2  Resi(z)eable
65
66              3  E(x)ported
67
68              4  (p)artial: one or more physical volumes belonging to the vol‐
69                 ume group are missing from the system
70
71              5  Allocation   policy:   (c)ontiguous,    c(l)ing,    (n)ormal,
72                 (a)nywhere, (i)nherited
73
74              6  (c)lustered
75
76       -O, --sort
77              Comma-separated  ordered  list  of columns to sort by.  Replaces
78              the default selection. Precede any column with - for  a  reverse
79              sort on that column.
80
81       --rows Output columns as rows.
82
83       --separator Separator
84              String  to  use to separate each column.  Useful if grepping the
85              output.
86
87       --unbuffered
88              Produce output immediately without sorting or aligning the  col‐
89              umns properly.
90
91       --units hHbBsSkKmMgGtTpPeE
92              All  sizes are output in these units: (h)uman-readable, (b)ytes,
93              (s)ectors, (k)ilobytes, (m)egabytes,  (g)igabytes,  (t)erabytes,
94              (p)etabytes,  (e)xabytes.   Capitalise  to use multiples of 1000
95              (S.I.) instead of 1024.  Can  also  specify  custom  units  e.g.
96              --units 3M
97
98       --unquoted
99              When  used with --nameprefixes, output values in the field=value
100              pairs are not quoted.
101

SEE ALSO

103       lvm(8), vgdisplay(8), pvs(8), lvs(8)
104
105
106
107Sistina Software UK    LVM TOOLS 2.02.84(2) (2011-02-09)                VGS(8)
Impressum