lvs man page on Archlinux

Man page or keyword search:  
man Server   11224 pages
apropos Keyword Search (all sections)
Output format
Archlinux 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]  [--ignoreskippedcluster]  [--nameprefixes]	[--noheadings]
       [--nosuffix]	  [-o|--options	     [+]Field[,Field]]	    [-O|--sort
       [+|-]Key1[,[+|-]Key2[,...]]]  [-P|--partial] [--rows] [--separator Sep‐
       arator]	 [--segments]	[--unbuffered]	 [--units  hHbBsSkKmMgGtTpPeE]
       [--unquoted] [-v|--verbose] [--version] [VolumeGroupName	 [VolumeGroup‐
       Name...]]

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_profile, lv_read_ahead, lv_size, lv_tags,
	      lv_time, lv_uuid,	 metadata_lv,  mirror_log,  modules,  move_pv,
	      origin,	  origin_size,	   pool_lv,    raid_max_recovery_rate,
	      raid_min_recovery_rate,  raid_mismatch_count,  raid_sync_action,
	      raid_write_behind,      region_size,     segtype,	    seg_count,
	      seg_pe_ranges, seg_size, seg_size_pe,  seg_start,	 seg_start_pe,
	      seg_tags,	  snap_percent,	 stripes,  stripe_size,	 sync_percent,
	      thin_count, transaction_id, writebehind, 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: (C)ache, (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 pool
		 m(e)tadata or pool metadata spare.

	      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	 Volume	 Health:  (p)artial,  (r)efresh	 needed,  (m)ismatches
		 exist,	 (w)ritemostly.	  (p)artial signifies that one or more
		 of the Physical Volumes this Logical Volume uses  is  missing
		 from the system.  (r)efresh signifies that one or more of the
		 Physical Volumes this RAID Logical Volume uses had suffered a
		 write	error.	 The  write  error could be due to a temporary
		 failure of that Physical Volume or an indication that	it  is
		 failing.    The  device  should  be  refreshed	 or  replaced.
		 (m)ismatches signifies that the RAID logical volume has  por‐
		 tions	of  the	 array that are not coherent.  Inconsistencies
		 are detected by initiating a "check" on a RAID	 logical  vol‐
		 ume.  (The scrubbing operations, "check" and "repair", can be
		 performed on a RAID logical volume via	 the  'lvchange'  com‐
		 mand.)	 (w)ritemostly signifies the devices in a RAID 1 logi‐
		 cal volume that have been marked write-mostly.

	      10 s(k)ip activation: this volume is flagged to be skipped  dur‐
		 ing activation.

       -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.106(2) (2014-04-10)		LVS(8)
[top]

List of man pages available for Archlinux

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