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

man: lvceate document external origin snapshot

Browse Source 
Document added support for external origin.
This commit is contained in:
Zdenek Kabelac 2013-04-05 12:56:19 +02:00
parent ddafa0115e
commit c22e925ce4
2 changed files with 20 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
WHATS_NEW
View File

@ -1,5 +1,6 @@
Version 2.02.99 - Version 2.02.99 -
=================================== ===================================
Add external origin support for lvcreate.
Improve lvcreate, lvconvert and lvm man pages. Improve lvcreate, lvconvert and lvm man pages.
Clean up format1 PV write to remove a need for an orphan VG for it to pass. Clean up format1 PV write to remove a need for an orphan VG for it to pass.
Fix vgextend to not allow a PV with 0 MDAs to be used while already in a VG. Fix vgextend to not allow a PV with 0 MDAs to be used while already in a VG.

20
man/lvcreate.8.in
View File

@ -59,7 +59,10 @@ lvcreate \- create a logical volume in an existing volume group
.RB [ \-\-poolmetadatasize .RB [ \-\-poolmetadatasize
.IR ThinPoolMetadataSize [ bBsSkKmMgG ]]] .IR ThinPoolMetadataSize [ bBsSkKmMgG ]]]
.RB [ \-\-thinpool .RB [ \-\-thinpool
.IR ThinPoolLogicalVolume { Name | Path }] .IR ThinPoolLogicalVolume { Name | Path }
.RB [ \-s | \-\-snapshot
.RI [ VolumeGroup { Name | Path }/]
.IR ExternalOriginLogicalVolumeName ]]
.RB [ \-\-type .RB [ \-\-type
.IR SegmentType ] .IR SegmentType ]
.RB [ \-v | \-\-verbose ] .RB [ \-v | \-\-verbose ]
@ -291,6 +294,15 @@ used to track the locations of the chunks of data, so you should
allocate slightly more space than you actually need and monitor allocate slightly more space than you actually need and monitor
(\fB\-\-monitor\fP) the rate at which the snapshot data is growing (\fB\-\-monitor\fP) the rate at which the snapshot data is growing
so you can \fBavoid\fP running out of space. so you can \fBavoid\fP running out of space.
If \fB\-\-thinpool\fP is specified, thin volume is created that will
use given original logical volume as an external origin that
serves unprovisioned blocks.
Only read-only volumes can be used as external origins.
To make the volume external origin, lvm expects the volume to be inactive.
External origin volume can be used/shared for many thin volumes
even from different thin pools. See
.BR lvconvert (8)
for online conversion to thin volumes with external origin.
.TP .TP
.IR \fB\-T ", " \fB\-\-thin ", " \fB\-\-thinpool " " ThinPoolLogicalVolume { Name | Path } .IR \fB\-T ", " \fB\-\-thin ", " \fB\-\-thinpool " " ThinPoolLogicalVolume { Name | Path }
Creates thin pool or thin logical volume or both. Creates thin pool or thin logical volume or both.
@ -407,9 +419,15 @@ build with 2 stripes 64KiB and chunk size 256KiB together with
.sp .sp
.B lvcreate \-i 2 \-I 64 \-c 256 \-L100M \-T vg00/pool \-V 1T \-\-name thin_lv .B lvcreate \-i 2 \-I 64 \-c 256 \-L100M \-T vg00/pool \-V 1T \-\-name thin_lv
Creates thin volume snapshot of read only inactive volume "vg00/origin"
that will use an existing thin pool "vg00/pool":
.sp
.B lvcreate -s --thinpool "vg00/pool" origin
.SH SEE ALSO .SH SEE ALSO
.BR lvm (8), .BR lvm (8),
.BR lvm.conf (5), .BR lvm.conf (5),
.BR lvconvert (8),
.BR lvchange (8), .BR lvchange (8),
.BR lvextend (8), .BR lvextend (8),
.BR lvreduce (8), .BR lvreduce (8),