LVS(8)								       LVS(8)



NAME
       lvs - report information about logical volumes

SYNOPSIS
       lvs  [--aligned]	 [-d/--debug] [-h/-?/--help] [--ignorelockingfailure]
       [--noheadings] [--nosuffix] [-o/--options [+]Field[,Field]] [-O/--sort
       [+/-]Key1[,[+/-]Key2[,...]]]  [-P/--partial] [--segments] [--separator
       Separator]  [--unbuffered]   [--units   hsbkmgtHKMGT]   [-v/--verbose]
       [--version] [VolumeGroupName [VolumeGroupName...]]

DESCRIPTION
       lvs produces formatted output about logical volumes.

OPTIONS
       See lvm for common options.

       --aligned
	      Use with --separator to align the output columns.

       --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.   Column  names  are: lv_uuid, lv_name, lv_attr,
	      lv_major, lv_minor, lv_kernel_major, lv_kernel_minor,  lv_size,
	      seg_count,   origin,   snap_percent,   copy_percent,   move_pv,
	      lv_tags, segtype, stripes,  stripesize,  chunksize,  seg_start,
	      seg_size, seg_tags, 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

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

	      3	 Allocation   policy:	(c)ontiguous,  (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

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

       --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 hsbkmgtHKMGT
	      All  sizes  are  output  in  these   units:   (h)uman-readable,
	      (s)ectors,   (b)ytes,  (k)ilobytes,  (m)egabytes,	 (g)igabytes,
	      (t)erabytes.   Capitalise	 to  use  multiples  of	 1000  (S.I.)
	      instead of 1024.	Can also specify custom (u)nits e.g.  --units
	      3M

SEE ALSO
       lvdisplay(8), pvs(8), vgs(8)



Sistina Software UK		  LVM TOOLS			       LVS(8)

UNIX/Linux commands referenced on this page:

1. lvm
2. vgs
3. sort
4. column