VGS(8)                                                        System Manager's Manual                                                       VGS(8)

NAME

       vgs - report information about volume groups

SYNOPSIS

       vgs  [-a|--all] [--aligned] [-d|--debug] [-h|-?|--help] [--ignorelockingfailure] [--nameprefixes] [--noheadings] [--nosuffix] [-o|--options
       [+]Field[,Field]] [-O|--sort [+|-]Key1[,[+|-]Key2[,...]]]  [-P|--partial] [--rows] [--separator Separator]  [--unbuffered]  [--units  hHbB-
       sSkKmMgGtTpPeE] [--unquoted] [-v|--verbose] [--version] [VolumeGroupName [VolumeGroupName...]]

DESCRIPTION

       vgs produces formatted output about volume groups.

OPTIONS

       See lvm for common options.

       --all  List all volume groups.  Equivalent to not specifying any volume groups.

       --aligned
              Use with --separator to align the output columns.

       --nameprefixes
              Add  an  "LVM2_" prefix plus the field name to the output.  Useful with --noheadings to produce a list of field=value pairs that can
              be used to set environment variables (for example, in udev (7) rules).

       --noheadings
              Suppress the headings line that is normally the first line of output.  Useful if grepping the output.

       --nosuffix
              Suppress the suffix on output sizes.  Use with --units (except h and H) if processing the output.

       -o, --options
              Comma-separated ordered list of columns.  Precede the list with '+' to append to the default selection of columns.

              Use -o vg_all to select all volume group columns.

              Use -o help to view the full list of columns available.

              Column names include: vg_fmt, vg_uuid, vg_name, vg_attr, vg_size, vg_free, vg_sysid, vg_extent_size, vg_extent_count, vg_free_count,
              max_lv, max_pv, pv_count, lv_count, snap_count, vg_seqno, vg_tags, vg_mda_count, vg_mda_free, and vg_mda_size, vg_mda_used_count.

              Any  "vg_"  prefixes  are  optional.  Columns mentioned in either pvs (8) or lvs (8) can also be chosen, but columns cannot be taken
              from both at the same time.

              The vg_attr bits are:

              1  Permissions: (w)riteable, (r)ead-only

              2  Resi(z)eable

              3  E(x)ported

              4  (p)artial: one or more physical volumes belonging to the volume group are missing from the system

              5  Allocation policy: (c)ontiguous, c(l)ing, (n)ormal, (a)nywhere, (i)nherited

              6  (c)lustered

       -O, --sort
              Comma-separated ordered list of columns to sort by.  Replaces the default selection. Precede any column with - for a reverse sort on
              that column.

       --rows Output columns as rows.

       --separator Separator
              String to use to separate each column.  Useful if grepping the output.

       --unbuffered
              Produce output immediately without sorting or aligning the columns properly.

       --units hHbBsSkKmMgGtTpPeE
              All  sizes  are  output  in  these  units: (h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes,
              (p)etabytes, (e)xabytes.  Capitalise to use multiples of 1000 (S.I.) instead of 1024.  Can also specify custom units e.g. --units 3M

       --unquoted
              When used with --nameprefixes, output values in the field=value pairs are not quoted.

SEE ALSO

       lvm(8), vgdisplay(8), pvs(8), lvs(8)

Sistina Software UK                                      LVM TOOLS 2.02.95(2) (2012-03-06)                                                  VGS(8)