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



NAME
       vgs -- report information about volume groups

SYNOPSIS
       vgs  [-a|--all]	[--aligned]  [--binary] [--commandprofile ProfileName]
       [[--configreport	 ReportName]  [-o|--options  [+|-|#]Field1[,Field2...]
       [-O|--sort    [+|-]Key1[,Key2...]]     [-S|--select   Selection]	  ...]
       [-d|--debug] [-h|-?|--help] [--ignorelockingfailure]  [--ignoreskipped-
       cluster]	  [--logonly]	[--nameprefixes]  [--noheadings]  [--nosuffix]
       [-P|--partial] [--reportformat {basic|json}] [--rows] [--separator Sep-
       arator]	 [--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.

       --binary
	      Use binary values "0" or "1" instead of descriptive literal val-
	      ues for columns that have exactly two  valid  values  to	report
	      (not  counting  the "unknown" value which denotes that the value
	      could not be determined).

       --configreport  ReportName
	      Make any subsequent -o, --options, -O, --sort or -S, --select to
	      apply  for  ReportName  where ReportName is either 'vg' for com-
	      mand's main report or 'log' for log report.   If	--configreport
	      option  is  not  used  to identify a report, then command's main
	      report is assumed. The log report is available only  if  enabled
	      by  log/report_command_log  lvm.conf(5)  setting or if --logonly
	      option is used.

       --logonly
	      Suppress the vgs report itself and display only  log  report  on
	      output.

       --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 current list of  col-
	      umns,  '-'  to remove from the current list of columns or '#' to
	      compact given columns. The -o option can be repeated,  providing
	      several lists. These lists are evaluated from left to right.

	      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 vol-
		 ume group are missing from the system

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

	      6	 (c)lustered, (s)hared

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

       -S, --select Selection
	      Display  only  rows  that match Selection criteria. All rows are
	      displayed with the additional "selected"	column	(-o  selected)
	      showing  1 if the row matches the Selection and 0 otherwise. The
	      Selection criteria are defined by specifying  column  names  and
	      their valid values (that can include reserved values) while mak-
	      ing use of supported comparison operators. See  lvm(8)  and  -S,
	      --select	description  for  more detailed information about con-
	      structing the Selection criteria. As a quick  help  and  to  see
	      full  list of column names that can be used in Selection includ-
	      ing the list of reserved values and the set of supported	selec-
	      tion operators, check the output of vgs -S help command.

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

       --unbuffered
	      Produce output immediately without sorting or aligning the  col-
	      umns 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 UKLVM TOOLS 2.02.166(2)-RHEL7 (2016-11-16)		VGS(8)