lvs man page on ElementaryOS

Man page or keyword search:  
man Server   4994 pages
apropos Keyword Search (all sections)
Output format
ElementaryOS logo
[printable version]

LVS(8)									LVS(8)

NAME
       lvs - report information about logical volumes

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

DESCRIPTION
       lvs produces formatted output about logical volumes.

OPTIONS
       See lvm(8) for common options.

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

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

       --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:  chunk_size,  convert_lv,	 copy_percent,
	      data_lv, devices, discards, lv_attr,  lv_host,  lv_kernel_major,
	      lv_kernel_minor,	 lv_kernel_read_ahead,	 lv_major,   lv_minor,
	      lv_name,	lv_path,  lv_read_ahead,  lv_size,  lv_tags,  lv_time,
	      lv_uuid, metadata_lv, mirror_log, modules, move_pv, origin, ori‐
	      gin_size,	   pool_lv,    region_size,    segtype,	    seg_count,
	      seg_pe_ranges,   seg_size,  seg_start,  seg_start_pe,  seg_tags,
	      snap_percent, stripes, stripe_size, thin_count,  transaction_id,
	      zero.

	      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,  (r)aid,	(R)aid
		 without   initial   sync,   (s)napshot,  merging  (S)napshot,
		 (p)vmove, (v)irtual, mirror or raid (i)mage, mirror  or  raid
		 (I)mage out-of-sync, mirror (l)og device, under (c)onversion,
		 thin (V)olume, (t)hin pool, (T)hin pool data,	raid  or  thin
		 pool m(e)tadata

	      2	 Permissions: (w)riteable, (r)ead-only, (R)ead-only activation
		 of non-read-only volume

	      3	 Allocation policy:   (a)nywhere,  (c)ontiguous,  (i)nherited,
		 c(l)ing,  (n)ormal  This is capitalised if the volume is cur‐
		 rently 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,	 snapshot  (m)erge  failed,  suspended
		 snapshot  (M)erge  failed,  mapped  (d)evice  present without
		 tables, mapped device present with (i)nactive table

	      6	 device (o)pen

	      7	 Target type: (m)irror, (r)aid, (s)napshot, (t)hin, (u)nknown,
		 (v)irtual.   This  groups logical volumes related to the same
		 kernel target together.  So, for example, mirror images, mir‐
		 ror  logs as well as mirrors themselves appear as (m) if they
		 use the original device-mapper mirror kernel driver;  whereas
		 the  raid  equivalents	 using	the  md raid kernel driver all
		 appear as (r).	 Snapshots using  the  original	 device-mapper
		 driver appear as (s); whereas snapshots of thin volumes using
		 the new thin provisioning driver appear as (t).

	      8	 Newly-allocated data blocks are overwritten  with  blocks  of
		 (z)eroes before use.

	      9	 (p)artial:  One  or more of the Physical Volumes this Logical
		 Volume uses is missing from the system.

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

       --segments
	      Use default columns that emphasize segment information.

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

Sistina Software UK    LVM TOOLS 2.02.98(2) (2012-10-15)		LVS(8)
[top]

List of man pages available for ElementaryOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net