Gitweb:
http://git.fedorahosted.org/git/?p=lvm2.git;a=commitdiff;h=d66f2574529ccc...
Commit: d66f2574529ccce5fab2c217805504f6a8fe1673
Parent: 33b96bef5bd8cfda3cf24007b84597f61a2cf0b6
Author: David Teigland <teigland(a)redhat.com>
AuthorDate: Wed Oct 1 10:29:30 2014 -0500
Committer: David Teigland <teigland(a)redhat.com>
CommitterDate: Wed Oct 1 10:44:18 2014 -0500
man: lvmthin mention alternate syntax
Users will probably run across the alternate syntax,
so we should explain how it relates to what is used here.
---
man/lvmthin.7.in | 78 ++++++++++++++++++++++++++++++++++-------------------
1 files changed, 50 insertions(+), 28 deletions(-)
diff --git a/man/lvmthin.7.in b/man/lvmthin.7.in
index af9669d..8009a9e 100644
--- a/man/lvmthin.7.in
+++ b/man/lvmthin.7.in
@@ -152,7 +152,8 @@ Create a new thin LV from the thin pool LV.
The thin LV is created with a virtual size.
Multiple new thin LVs may be created in the thin pool.
Thin LV names must be unique in the VG.
-The thinpool argument specifies which thin pool will
+The '--type thin' option is inferred from the virtual size option.
+The --thinpool argument specifies which thin pool will
contain the ThinLV.
.fi
@@ -225,6 +226,10 @@ or vgchange to activate thin snapshots with the "k"
attribute.
.SH Thin Topics
+.B Alternate syntax for specifying type thin\-pool
+.br
+.B Automatic pool metadata LV
+.br
.B Specify devices for data and metadata LVs
.br
.B Tolerate device failures using raid
@@ -233,8 +238,6 @@ or vgchange to activate thin snapshots with the "k"
attribute.
.br
.B Metadata check and repair
.br
-.B Automatic pool metadata LV
-.br
.B Activation of thin snapshots
.br
.B Removing thin pool LVs, thin LVs and snapshots
@@ -273,6 +276,50 @@ or vgchange to activate thin snapshots with the "k"
attribute.
\&
+.SS Alternate syntax for specifying type thin\-pool
+
+\&
+
+The fully specified syntax for creating a thin pool LV shown above is:
+
+.B lvconvert \-\-type thin-pool \-\-poolmetadata VG/ThinMetaLV VG/ThinDataLV
+
+An existing LV is converted to a thin pool by changing its type to
+thin-pool. An alternate syntax may be used for the same operation:
+
+.B lvconvert \-\-thinpool VG/ThinDataLV \-\-poolmetadata VG/ThinMetaLV
+
+The thin-pool type is inferred by lvm; the --thinpool option is not an
+alias for --type thin-pool. The use of the --thinpool option here is
+different from the use of the --thinpool option when creating a thin LV,
+where it specifies the pool in which the thin LV is created.
+
+
+.SS Automatic pool metadata LV
+
+\&
+
+A thin data LV can be converted to a thin pool LV without specifying a
+thin pool metadata LV. LVM automatically creates a metadata LV from the
+same VG.
+
+.B lvcreate \-n ThinDataLV \-L LargeSize VG
+.br
+.B lvconvert \-\-type thin\-pool VG/ThinDataLV
+
+.I Example
+.br
+.nf
+# lvcreate \-n pool0 \-L 10G vg
+# lvconvert \-\-type thin\-pool vg/pool0
+
+# lvs \-a
+ pool0 vg twi-a-tz-- 10.00g
+ [pool0_tdata] vg Twi-ao---- 10.00g
+ [pool0_tmeta] vg ewi-ao---- 16.00m
+.fi
+
+
.SS Specify devices for data and metadata LVs
\&
@@ -420,31 +467,6 @@ containing new metadata:
.B lvconvert \-\-thinpool VG/ThinPoolLV \-\-poolmetadata VG/NewThinMetaLV
-.SS Automatic pool metadata LV
-
-\&
-
-A thin data LV can be converted to a thin pool LV without
-specifying a thin pool metadata LV. LVM will automatically
-create a metadata LV from the same VG.
-
-.B lvcreate \-n ThinDataLV \-L LargeSize VG
-.br
-.B lvconvert \-\-type thin\-pool VG/ThinDataLV
-
-.I Example
-.br
-.nf
-# lvcreate \-n pool0 \-L 10G vg
-# lvconvert \-\-type thin\-pool vg/pool0
-
-# lvs \-a
- pool0 vg twi-a-tz-- 10.00g
- [pool0_tdata] vg Twi-ao---- 10.00g
- [pool0_tmeta] vg ewi-ao---- 16.00m
-.fi
-
-
.SS Activation of thin snapshots
\&