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]
   [--ignoreskippedcluster]  [--logonly]  [--nameprefixes]  [--noheadings]
   [--nosuffix]  [-P|--partial]  [--reportformat  {basic|json}]   [--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.

   --binary
          Use binary values "0" or  "1"  instead  of  descriptive  literal
          values  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
          command'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
          columns, '-' 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
             volume 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
          making use of supported comparison operators. See lvm(8) and -S,
          --select   description   for  more  detailed  information  about
          constructing the Selection criteria. As a quick help and to  see
          full  list  of  column  names  that  can  be  used  in Selection
          including the list of reserved values and the set  of  supported
          selection 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
          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)





Opportunity


Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.





Free Software


Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.


Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.





Free Books


The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.


Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.





Education


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.


Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.