Man Linux: Main Page and Category List


       lvs - report information about logical volumes


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


       lvs produces formatted output about logical volumes.


       See lvm for common options.

       --all  Include information in the output about internal Logical Volumes
              that are components of normally-accessible Logical Volumes, such
              as mirrors, but which are not independently accessible (e.g. not
              mountable).   The  names  of  such  Logical Volumes are enclosed
              within square  brackets  in  the  output.   For  example,  after
              creating  a  mirror  using ’lvcreate -m1 --mirrorlog disk’, this
              option will reveal three internal Logical Volumes, with suffixes
              mimage_0, mimage_1, and mlog.

              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 instead of
              replacing it.

              Use -o lv_all to select  all  logical  volume  columns,  and  -o
              seg_all to select all logical volume segment columns.

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

              Column  names  include:  lv_uuid,  lv_name,  lv_attr,  lv_major,
              lv_minor,   lv_read_ahead,   lv_kernel_major,   lv_kernel_minor,
              lv_kernel_read_ahead,  lv_size,  seg_count, origin, origin_size,
              snap_percent,  copy_percent,   move_pv,   convert_lv,   lv_tags,
              mirror_log,  modules,  segtype, stripes, stripesize, regionsize,
              chunksize,   seg_start,   seg_start_pe,   seg_size,    seg_tags,
              seg_pe_ranges, devices.

              With --segments, any "seg_" prefixes are optional; otherwise any
              "lv_" prefixes are optional.  Columns mentioned in vgs  (8)  can
              also be chosen.

              The lv_attr bits are:

              1  Volume  type:  (m)irrored,  (M)irrored  without initial sync,
                 (o)rigin,   (p)vmove,   (s)napshot,    invalid    (S)napshot,
                 (v)irtual,  mirror (i)mage, mirror (I)mage out-of-sync, under

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

              3  Allocation   policy:   (c)ontiguous,    c(l)ing,    (n)ormal,
                 (a)nywhere,  (i)nherited This is capitalised if the volume is
                 currently locked  against  allocation  changes,  for  example
                 during pvmove (8).

              4  fixed (m)inor

              5  State:  (a)ctive,  (s)uspended,  (I)nvalid  snapshot, invalid
                 (S)uspended snapshot, mapped (d)evice present without tables,
                 mapped device present with (i)nactive table

              6  device (o)pen

              Use default columns that emphasize segment information.

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

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


       lvm(8), lvdisplay(8), pvs(8), vgs(8)