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] [--ignoreskippedcluster] [--nameprefixes] [--noheadings]
       [--nosuffix] [-o|--options [+]Field1[,Field2...]]  [-O|--sort [+|-]Key1[,[+|-]Key2...]]	[-P|--partial]	[--rows]  [--separator	Separator]
       [--unbuffered] [--units hHbBsSkKmMgGtTpPeE] [--unquoted] [-v|--verbose] [--version] [VolumeGroupName [VolumeGroupName...]]

DESCRIPTION

       vgs produces formatted output about volume groups.

OPTIONS

       See lvm(8) 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,
	      vg_profile,  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.105(2)-RHEL7 (2014-03-26)						    VGS(8)