NAME
       lvs - report information about logical volumes

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

DESCRIPTION
       lvs produces formatted output about logical volumes.

OPTIONS
       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 creat-
              ing  a mirror using 'lvcreate -m1 --mirrorlog disk', this option
              will reveal three internal Logical Volumes, with  suffixes  mim-
              age_0, mimage_1, and mlog.

       --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 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_path,  lv_attr,
              lv_major,  lv_minor,  lv_read_ahead,  lv_kernel_major,   lv_ker-
              nel_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, (O)rigin with merging snapshot, (s)napshot, merging
                 (S)napshot,   (p)vmove,  (v)irtual,  mirror  (i)mage,  mirror
                 (I)mage out-of-sync, under (c)onversion

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

       --segments
              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
              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), lvdisplay(8), pvs(8), vgs(8)

Sistina Software UK LVM TOOLS 2.02.88(2)-RHEL5 (2013-06-25)             LVS(8)