lvs man page on Slackware

Man page or keyword search:  
man Server   14563 pages
apropos Keyword Search (all sections)
Output format
Slackware 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_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_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:	(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 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 or  that  the	 array
		 has recently repaired inconsistencies.	 An additional "check"
		 after a "repair" of a RAID logical  volume  will  clear  this
		 flag  if no additional discrepancies are found.  ("check" and
		 "repair" of a	RAID  Logical  Volume  can  be	done  via  the
		 'lvchange'  command.)	(w)ritemostly signifies the devices in
		 a RAID 1 logical 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.100(2) (2013-08-13)		LVS(8)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Slackware

List of man pages available for Slackware

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