1VGS(8) System Manager's Manual VGS(8)
2
3
4
6 vgs - report information about volume groups
7
9 vgs [--aligned] [-d/--debug] [-h/-?/--help] [--ignorelockingfailure]
10 [--noheadings] [--nosuffix] [-o/--options [+]Field[,Field]] [-O/--sort
11 [+/-]Key1[,[+/-]Key2[,...]]] [-P/--partial] [--separator Separator]
12 [--unbuffered] [--units hsbkmgtHKMGT] [-v/--verbose] [--version] [Vol‐
13 umeGroupName [VolumeGroupName...]]
14
16 vgs produces formatted output about volume groups.
17
19 See lvm for common options.
20
21 --aligned
22 Use with --separator to align the output columns.
23
24 --noheadings
25 Suppress the headings line that is normally the first line of
26 output. Useful if grepping the output.
27
28 --nosuffix
29 Suppress the suffix on output sizes. Use with --units (except h
30 and H) if processing the output.
31
32 -o, --options
33 Comma-separated ordered list of columns. Precede the list with
34 '+' to append to the default selection of columns. Column names
35 are: vg_fmt, vg_uuid, vg_name, vg_attr, vg_size, vg_free,
36 vg_sysid, vg_extent_size, vg_extent_count, vg_free_count,
37 max_lv, max_pv, pv_count, lv_count, snap_count, vg_seqno,
38 vg_tags. Any "vg_" prefixes are optional. Columns mentioned in
39 either pvs (8) or lvs (8) can also be chosen, but columns cannot
40 be taken from both at the same time. The vg_attr bits are:
41 (w)riteable, (r)eadonly, resi(z)eable, e(x)ported, (p)artial and
42 (c)lustered. Use -o help to view the full list of fields avail‐
43 able.
44
45 -O, --sort
46 Comma-separated ordered list of columns to sort by. Replaces
47 the default selection. Precede any column with - for a reverse
48 sort on that column.
49
50 --separator Separator
51 String to use to separate each column. Useful if grepping the
52 output.
53
54 --unbuffered
55 Produce output immediately without sorting or aligning the col‐
56 umns properly.
57
58 --units hsbkmgtHKMGT
59 All sizes are output in these units: (h)uman-readable,
60 (s)ectors, (b)ytes, (k)ilobytes, (m)egabytes, (g)igabytes,
61 (t)erabytes. Capitalise to use multiples of 1000 (S.I.) instead
62 of 1024. Can also specify custom (u)nits e.g. --units 3M
63
65 vgdisplay(8), pvs(8), lvs(8)
66
67
68
69Sistina Software UK LVM TOOLS VGS(8)