shaba/lvm2
1
0
Fork 0
mirror of git://sourceware.org/git/lvm2.git synced 2025-01-04 09:18:36 +03:00
Code Releases Activity

Revert "Revert "man: lvmthin should use clearer thin pool options""

Browse Source 
This reverts commit 17a1869df5.

We've agreed on the clearer syntax.
This commit is contained in:
David Teigland 2014-09-29 12:26:16 -05:00
parent d1be66ba37
commit 9646c3359f
1 changed files with 31 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

50
man/lvmthin.7.in
View File

@ -129,11 +129,11 @@ ThinMetaLV is renamed to hidden ThinPoolLV_tmeta.
The new ThinPoolLV takes the previous name of ThinDataLV. The new ThinPoolLV takes the previous name of ThinDataLV.
.fi .fi
.B lvconvert \-\-thinpool VG/ThinDataLV \-\-poolmetadata VG/ThinMetaLV .B lvconvert \-\-type thin-pool \-\-poolmetadata VG/ThinMetaLV VG/ThinDataLV
.I Example .I Example
.br .br
# lvconvert \-\-thinpool vg/pool0 \-\-poolmetadata vg/pool0meta # lvconvert \-\-type thin-pool \-\-poolmetadata vg/pool0meta vg/pool0
# lvs vg/pool0 # lvs vg/pool0
LV VG Attr LSize Pool Origin Data% Meta% LV VG Attr LSize Pool Origin Data% Meta%
@ -286,14 +286,14 @@ to use fast devices for the metadata LV.
.br .br
.B lvcreate \-n ThinMetaLV \-L SmallSize VG SmallPV .B lvcreate \-n ThinMetaLV \-L SmallSize VG SmallPV
.br .br
.B lvconvert \-\-thinpool VG/ThinDataLV \-\-poolmetadata VG/ThinMetaLV .B lvconvert \-\-type thin\-pool \-\-poolmetadata VG/ThinMetaLV VG/ThinDataLV
.I Example .I Example
.br .br
.nf .nf
# lvcreate \-n pool0 \-L 10G vg /dev/sdA # lvcreate \-n pool0 \-L 10G vg /dev/sdA
# lvcreate \-n pool0meta \-L 1G vg /dev/sdB # lvcreate \-n pool0meta \-L 1G vg /dev/sdB
# lvconvert \-\-thinpool vg/pool0 \-\-poolmetadata vg/pool0meta # lvconvert \-\-type thin\-pool \-\-poolmetadata vg/pool0meta vg/pool0
.fi .fi
.BR lvm.conf (5) .BR lvm.conf (5)
@ -314,14 +314,14 @@ pool metadata LV. This is especially recommended for pool metadata LVs.
.br .br
.B lvcreate \-\-type raid1 \-m 1 \-n ThinDataLV \-L LargeSize VG PVC PVD .B lvcreate \-\-type raid1 \-m 1 \-n ThinDataLV \-L LargeSize VG PVC PVD
.br .br
.B lvconvert \-\-thinpool VG/ThinDataLV \-\-poolmetadata VG/ThinMetaLV .B lvconvert \-\-type thin\-pool \-\-poolmetadata VG/ThinMetaLV VG/ThinDataLV
.I Example .I Example
.br .br
.nf .nf
# lvcreate \-\-type raid1 \-m 1 \-n pool0 \-L 10G vg /dev/sdA /dev/sdB # lvcreate \-\-type raid1 \-m 1 \-n pool0 \-L 10G vg /dev/sdA /dev/sdB
# lvcreate \-\-type raid1 \-m 1 \-n pool0meta \-L 1G vg /dev/sdC /dev/sdD # lvcreate \-\-type raid1 \-m 1 \-n pool0meta \-L 1G vg /dev/sdC /dev/sdD
# lvconvert \-\-thinpool vg/pool0 \-\-poolmetadata vg/pool0meta # lvconvert \-\-type thin\-pool \-\-poolmetadata vg/pool0meta vg/pool0
.fi .fi
@ -348,7 +348,7 @@ explicitly.
.nf .nf
# lvcreate \-n pool0 \-L 10G vg # lvcreate \-n pool0 \-L 10G vg
# lvcreate \-n pool0meta \-L 1G vg # lvcreate \-n pool0meta \-L 1G vg
# lvconvert \-\-thinpool vg/pool0 \-\-poolmetadata vg/pool0meta # lvconvert \-\-type thin\-pool \-\-poolmetadata vg/pool0meta vg/pool0
# lvs \-a # lvs \-a
[lvol0_pmspare] vg ewi------- 10.00g [lvol0_pmspare] vg ewi------- 10.00g
@ -430,13 +430,13 @@ create a metadata LV from the same VG.
.B lvcreate \-n ThinDataLV \-L LargeSize VG .B lvcreate \-n ThinDataLV \-L LargeSize VG
.br .br
.B lvconvert \-\-thinpool VG/ThinDataLV .B lvconvert \-\-type thin\-pool VG/ThinDataLV
.I Example .I Example
.br .br
.nf .nf
# lvcreate \-n pool0 \-L 10G vg # lvcreate \-n pool0 \-L 10G vg
# lvconvert \-\-thinpool vg/pool0 # lvconvert \-\-type thin\-pool vg/pool0
# lvs \-a # lvs \-a
pool0 vg twi-a-tz-- 10.00g pool0 vg twi-a-tz-- 10.00g
@ -772,10 +772,11 @@ indicated by the "z" attribute displayed by lvs. The option \-Z
Command to set the zeroing mode when creating a thin pool LV: Command to set the zeroing mode when creating a thin pool LV:
.br .br
.B lvconvert \-Z{y|n} \-\-thinpool VG/ThinDataLV .B lvconvert \-\-type thin\-pool \-Z{y|n}
.br .br
.B " " \-\-poolmetadata VG/ThinMetaLV .RS
.B \-\-poolmetadata VG/ThinMetaLV VG/ThinDataLV
.RE
Command to change the zeroing mode of an existing thin pool LV: Command to change the zeroing mode of an existing thin pool LV:
.br .br
@ -819,7 +820,7 @@ Command to set the discard mode when creating a thin pool LV:
.B lvconvert \-\-discards {ignore|nopassdown|passdown} .B lvconvert \-\-discards {ignore|nopassdown|passdown}
.br .br
.RS .RS
.B \-\-thinpool VG/ThinDataLV \-\-poolmetadata VG/ThinMetaLV .B \-\-type thin\-pool \-\-poolmetadata VG/ThinMetaLV VG/ThinDataLV
.RE .RE
Command to change the discard mode of an existing thin pool LV: Command to change the discard mode of an existing thin pool LV:
@ -966,12 +967,16 @@ rather than using lvconvert on existing LVs.
This one command creates a thin data LV, a thin metadata LV, This one command creates a thin data LV, a thin metadata LV,
and combines the two into a thin pool LV. and combines the two into a thin pool LV.
.B lvcreate \-L LargeSize \-\-thinpool VG/ThinPoolLV .B lvcreate \-\-type thin\-pool \-L LargeSize VG/ThinPoolLV
./" FIXME: make this work
./" or using standard form of lvcreate:
./" .B lvcreate \-\-type thin\-pool \-L LargeSize \-n ThinPoolLV VG
.I Example .I Example
.br .br
.nf .nf
# lvcreate \-L8M \-\-thinpool vg/pool0 # lvcreate \-\-type thin\-pool \-L8M vg/pool0
# lvs vg/pool0 # lvs vg/pool0
LV VG Attr LSize Pool Origin Data% LV VG Attr LSize Pool Origin Data%
@ -997,13 +1002,17 @@ and creates a thin LV in the new pool.
.br .br
\-V VirtualSize specifies the virtual size of the thin LV. \-V VirtualSize specifies the virtual size of the thin LV.
.B lvcreate \-L LargeSize \-V VirtualSize \-n ThinLV .B lvcreate \-V VirtualSize \-L LargeSize
.br .RS
.B " " \-\-thinpool VG/ThinPoolLV .B \-n ThinLV \-\-thinpool VG/ThinPoolLV
.RE
./" FIXME: make this work
./" lvcreate \-\-type thin\-pool \-V VirtualSize \-L LargeSize \-n ThinLV VG/ThinPoolLV
Equivalent to: Equivalent to:
.br .br
.B lvcreate \-L LargeSize \-\-thinpool VG/ThinPoolLV .B lvcreate \-\-type thin\-pool \-L LargeSize VG/ThinPoolLV
.br .br
.B lvcreate \-n ThinLV \-V VirtualSize \-\-thinpool VG/ThinPoolLV .B lvcreate \-n ThinLV \-V VirtualSize \-\-thinpool VG/ThinPoolLV
@ -1012,6 +1021,9 @@ Equivalent to:
.nf .nf
# lvcreate \-L8M \-V2G \-n thin1 \-\-thinpool vg/pool0 # lvcreate \-L8M \-V2G \-n thin1 \-\-thinpool vg/pool0
./" FIXME: change to
./" lvcreate \-\-type thin\-pool \-L8M \-V2G \-n thin1 vg/pool0
# lvs \-a # lvs \-a
pool0 vg twi-a-tz-- 8.00m pool0 vg twi-a-tz-- 8.00m
[pool0_tdata] vg Twi-ao---- 8.00m [pool0_tdata] vg Twi-ao---- 8.00m