VGS(8)                                                                  VGS(8)

       vgs - report information about volume groups

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

       vgs produces formatted output about volume groups.

       See lvm for common options.

              Use with --separator to align the output columns.

              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).

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

              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.  Column names
              are:   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.  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.  Use -o help to view the full list of
              fields available.

              The vg_attr bits are:

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

              2  Resi(z)eable

              3  E(x)ported

              4  (p)artial

              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

              Produce output immediately without sorting or aligning the  col-
              umns properly.

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

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

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

Sistina Software UK    LVM TOOLS 2.02.44-cvs (02-17-09)                 VGS(8)

You can also request any man page by name and (optionally) by section:


Use the DEFAULT collection to view manual pages for third-party software.

©1994 Man-cgi 1.15, Panagiotis Christias <>
©1996-2015 Modified for NetBSD by Kimmo Suominen