public inbox for lvm2-cvs@sourceware.org
help / color / mirror / Atom feed
* LVM2/man lvcreate.8.in
@ 2012-01-20 10:50 zkabelac
0 siblings, 0 replies; 10+ messages in thread
From: zkabelac @ 2012-01-20 10:50 UTC (permalink / raw)
To: lvm-devel, lvm2-cvs
CVSROOT: /cvs/lvm2
Module name: LVM2
Changes by: zkabelac@sourceware.org 2012-01-20 10:50:40
Modified files:
man : lvcreate.8.in
Log message:
Thin extend lvcreate man page about snapshot support
Patches:
http://sourceware.org/cgi-bin/cvsweb.cgi/LVM2/man/lvcreate.8.in.diff?cvsroot=lvm2&r1=1.34&r2=1.35
--- LVM2/man/lvcreate.8.in 2011/12/21 13:58:38 1.34
+++ LVM2/man/lvcreate.8.in 2012/01/20 10:50:39 1.35
@@ -81,9 +81,7 @@
.RB [ \-n | \-\-name
.IR SnapshotLogicalVolume { Name | Path }]
.BR \-s | \-\-snapshot
-.RI { OriginalLogicalVolume { Name | Path }
-|
-.IR VolumeGroup { Name | Path }
+.RI {[ VolumeGroup { Name | Path }/] OriginalLogicalVolumeName
.BR \-V | \-\-virtualsize
.IR VirtualSize [ bBsSkKmMgGtTpPeE ]}
.br
@@ -241,16 +239,19 @@
A mirror is divided into regions of this size (in MB), and the mirror log
uses this granularity to track which regions are in sync.
.TP
-.IR \fB\-s ", " \fB\-\-snapshot " " OriginalLogicalVolume { Name | Path }
-.RI "| " VolumeGroup { Name | Path }
+.IR \fB\-s ", " \fB\-\-snapshot " " OriginalLogicalVolume { Name | Path }
Create a snapshot logical volume (or snapshot) for an existing, so called
original logical volume (or origin).
Snapshots provide a 'frozen image' of the contents of the origin
while the origin can still be updated. They enable consistent
-backups and online recovery of removed/overwritten data/files. The snapshot
-does not need the same amount of storage the origin has. In a typical scenario,
-15-20% might be enough. In case the snapshot runs out of storage, use
+backups and online recovery of removed/overwritten data/files.
+Thin snapshot is created when the origin is a thin volume and
+the size is not specified. Thin snapshot shares same blocks within
+the thin pool volume.
+The snapshot with the specified size does not need the same amount of
+storage the origin has. In a typical scenario, 15-20% might be enough.
+In case the snapshot runs out of storage, use
.BR lvextend (8)
to grow it. Shrinking a snapshot is supported by
.BR lvreduce (8)
^ permalink raw reply [flat|nested] 10+ messages in thread
* LVM2/man lvcreate.8.in
@ 2011-12-21 13:58 zkabelac
0 siblings, 0 replies; 10+ messages in thread
From: zkabelac @ 2011-12-21 13:58 UTC (permalink / raw)
To: lvm-devel, lvm2-cvs
CVSROOT: /cvs/lvm2
Module name: LVM2
Changes by: zkabelac@sourceware.org 2011-12-21 13:58:39
Modified files:
man : lvcreate.8.in
Log message:
Thin man page update
Patches:
http://sourceware.org/cgi-bin/cvsweb.cgi/LVM2/man/lvcreate.8.in.diff?cvsroot=lvm2&r1=1.33&r2=1.34
--- LVM2/man/lvcreate.8.in 2011/11/10 12:41:39 1.33
+++ LVM2/man/lvcreate.8.in 2011/12/21 13:58:38 1.34
@@ -52,7 +52,6 @@
.RI { ReadAheadSectors | auto | none }]
.RB [ \-t | \-\-test ]
.RB [ \-T | \-\-thin
-.RI [ ThinPoolLogicalVolume { Name | Path }]
.RB [ \-c | \-\-chunksize
.IR ChunkSize ]
.RB [ \-\-poolmetadatasize
@@ -277,7 +276,7 @@
.TP
.B \-\-type \fISegmentType
Create a logical volume that uses the specified segment type
-(e.g. "raid5", "mirror", "snapshot", "thin", "thin_pool").
+(e.g. "raid5", "mirror", "snapshot", "thin", "thin-pool").
Many segment types have a
commandline switch alias that will enable their use (-s is an alias for
--type snapshot). However, this argument must be used when no existing
^ permalink raw reply [flat|nested] 10+ messages in thread
* LVM2/man lvcreate.8.in
@ 2011-11-10 12:41 zkabelac
0 siblings, 0 replies; 10+ messages in thread
From: zkabelac @ 2011-11-10 12:41 UTC (permalink / raw)
To: lvm-devel, lvm2-cvs
CVSROOT: /cvs/lvm2
Module name: LVM2
Changes by: zkabelac@sourceware.org 2011-11-10 12:41:39
Modified files:
man : lvcreate.8.in
Log message:
Thin lvcreate manpage
Merge thin creation into standard 1st. lvcreate.
Update snapshot for thin support.
Patches:
http://sourceware.org/cgi-bin/cvsweb.cgi/LVM2/man/lvcreate.8.in.diff?cvsroot=lvm2&r1=1.32&r2=1.33
--- LVM2/man/lvcreate.8.in 2011/11/08 12:12:31 1.32
+++ LVM2/man/lvcreate.8.in 2011/11/10 12:41:39 1.33
@@ -23,11 +23,14 @@
.IR Stripes
.RB [ \-I | \-\-stripesize
.IR StripeSize ]]
-.RB { \-l | \-\-extents
+.RB {[ \-l | \-\-extents
.IR LogicalExtentsNumber [ % { VG | PVS | FREE }]
|
.BR \-L | \-\-size
-.IR LogicalVolumeSize [ bBsSkKmMgGtTpPeE ]}
+.IR LogicalVolumeSize [ bBsSkKmMgGtTpPeE ]]
+|
+.BR \-V | \-\-virtualsize
+.IR VirtualSize [ bBsSkKmMgGtTpPeE ]}
.RB [ \-M | \-\-persistent
.RI { y | n }]
.RB [ \-\-minor
@@ -48,21 +51,29 @@
.RB [ \-r | \-\-readahead
.RI { ReadAheadSectors | auto | none }]
.RB [ \-t | \-\-test ]
+.RB [ \-T | \-\-thin
+.RI [ ThinPoolLogicalVolume { Name | Path }]
+.RB [ \-c | \-\-chunksize
+.IR ChunkSize ]
+.RB [ \-\-poolmetadatasize
+.IR MetadataSize [ bBsSkKmMgG ]]]
+.RB [ \-\-thinpool
+.IR ThinPoolLogicalVolume { Name | Path }]
.RB [ \-\-type
.IR SegmentType ]
.RB [ \-v | \-\-verbose ]
.RB [ \-Z | \-\-zero
.RI { y | n }]
-.IR VolumeGroup { Name | Path }
+.IR VolumeGroup { Name | Path }[/ ThinPoolLogicalVolumeName ]
.RI [ PhysicalVolumePath [ :PE [ -PE ]]...]
.br
.B lvcreate
-.RB { \-l | \-\-extents
+.RB [ \-l | \-\-extents
.IR LogicalExtentsNumber [ % { VG | FREE | ORIGIN }]
|
.BR \-L | \-\-size
-.IR LogicalVolumeSize [ bBsSkKmMgGtTpPeE ]}
+.IR LogicalVolumeSize [ bBsSkKmMgGtTpPeE ]]
.RB [ \-c | \-\-chunksize
.IR ChunkSize ]
.RB [ \-\-noudevsync ]
@@ -78,30 +89,6 @@
.IR VirtualSize [ bBsSkKmMgGtTpPeE ]}
.br
-.B lvcreate
-.BR \-T | \-\-thin
-.IR VolumeGroup { Name | Path }[/ ThinPoolLogicalVolumeName ]
-.RB [{ \-l | \-\-extents
-.IR LogicalExtentsNumber [ % { VG | FREE | ORIGIN }]
-|
-.BR \-L | \-\-size
-.IR LogicalVolumeSize [ bBsSkKmMgGtTpPeE ]}
-.RB [ \-i | \-\-stripes
-.IR Stripes
-.RB [ \-I | \-\-stripesize
-.IR StripeSize ]]
-.RB [ \-c | \-\-chunksize
-.IR ChunkSize ]
-.RB [ \-\-poolmetadatasize
-.IR MetadataSize [ bBsSkKmMgG ]]]
-.RB [ \-\-thinpool
-.IR ThinPoolLogicalVolume { Name | Path }]
-.RB [ \-V | \-\-virtualsize
-.IR VirtualSize [ bBsSkKmMgGtTpPeE ]]
-.RB [ \-n | \-\-name
-.IR ThinLogicalVolume { Name | Path }]
-.br
-
.SH DESCRIPTION
lvcreate creates a new logical volume in a volume group ( see
.BR vgcreate "(8), " vgchange (8)
^ permalink raw reply [flat|nested] 10+ messages in thread
* LVM2/man lvcreate.8.in
@ 2011-11-08 12:12 zkabelac
0 siblings, 0 replies; 10+ messages in thread
From: zkabelac @ 2011-11-08 12:12 UTC (permalink / raw)
To: lvm-devel, lvm2-cvs
CVSROOT: /cvs/lvm2
Module name: LVM2
Changes by: zkabelac@sourceware.org 2011-11-08 12:12:32
Modified files:
man : lvcreate.8.in
Log message:
More lvcreate man updates
Use { Name | Path } consistently like elsewhere.
Move --thin alphabetically before --type.
Patches:
http://sourceware.org/cgi-bin/cvsweb.cgi/LVM2/man/lvcreate.8.in.diff?cvsroot=lvm2&r1=1.31&r2=1.32
--- LVM2/man/lvcreate.8.in 2011/11/07 10:59:55 1.31
+++ LVM2/man/lvcreate.8.in 2011/11/08 12:12:31 1.32
@@ -42,7 +42,7 @@
.RB [ \-R | \-\-regionsize
.IR MirrorLogRegionSize ]]
.RB [ \-n | \-\-name
-.IR LogicalVolumeName [ Path ]]
+.IR LogicalVolume { Name | Path }]
.RB [ \-p | \-\-permission
.RI { r | rw }]
.RB [ \-r | \-\-readahead
@@ -53,7 +53,7 @@
.RB [ \-v | \-\-verbose ]
.RB [ \-Z | \-\-zero
.RI { y | n }]
-.IR VolumeGroupName [ Path ]
+.IR VolumeGroup { Name | Path }
.RI [ PhysicalVolumePath [ :PE [ -PE ]]...]
.br
@@ -69,18 +69,18 @@
.RB [ \-\-ignoremonitoring ]
.RB [ \-\-monitor " {" \fIy | \fIn }]
.RB [ \-n | \-\-name
-.IR SnapshotLogicalVolumeName [ Path ]]
+.IR SnapshotLogicalVolume { Name | Path }]
.BR \-s | \-\-snapshot
-.RI [ OriginalLogicalVolume [ Path ]
+.RI { OriginalLogicalVolume { Name | Path }
|
-.IR VolumeGroupName [ Path ]
+.IR VolumeGroup { Name | Path }
.BR \-V | \-\-virtualsize
-.IR VirtualSize [ bBsSkKmMgGtTpPeE ]]
+.IR VirtualSize [ bBsSkKmMgGtTpPeE ]}
.br
.B lvcreate
.BR \-T | \-\-thin
-.IR VolumeGroupName [ Path ][/ ThinPoolLogicalVolumeName
+.IR VolumeGroup { Name | Path }[/ ThinPoolLogicalVolumeName ]
.RB [{ \-l | \-\-extents
.IR LogicalExtentsNumber [ % { VG | FREE | ORIGIN }]
|
@@ -95,11 +95,11 @@
.RB [ \-\-poolmetadatasize
.IR MetadataSize [ bBsSkKmMgG ]]]
.RB [ \-\-thinpool
-.IR ThinPoolLogicalVolumeName [ Path ]]
+.IR ThinPoolLogicalVolume { Name | Path }]
.RB [ \-V | \-\-virtualsize
.IR VirtualSize [ bBsSkKmMgGtTpPeE ]]
.RB [ \-n | \-\-name
-.IR ThinLogicalVolumeName [ Path ]]
+.IR ThinLogicalVolume { Name | Path }]
.br
.SH DESCRIPTION
@@ -206,7 +206,7 @@
The optional argument --corelog is equivalent to --mirrorlog core.
.TP
-.BR \-n ", " \-\-name " " \fILogicalVolumeName
+.IR \fB\-n ", " \fB\-\-name " " LogicalVolume { Name | Path }
The name for the new logical volume.
.br
Without this option a default names of "lvol#" will be generated where
@@ -255,7 +255,9 @@
A mirror is divided into regions of this size (in MB), and the mirror log
uses this granularity to track which regions are in sync.
.TP
-.BR \-s ", " \-\-snapshot
+.IR \fB\-s ", " \fB\-\-snapshot " " OriginalLogicalVolume { Name | Path }
+.RI "| " VolumeGroup { Name | Path }
+
Create a snapshot logical volume (or snapshot) for an existing, so called
original logical volume (or origin).
Snapshots provide a 'frozen image' of the contents of the origin
@@ -275,16 +277,7 @@
rate at which the snapshot data is growing so you can avoid running out
of space.
.TP
-.B \-\-type \fISegmentType
-Create a logical volume that uses the specified segment type
-(e.g. "raid5", "mirror", "snapshot", "thin", "thin_pool").
-Many segment types have a
-commandline switch alias that will enable their use (-s is an alias for
---type snapshot). However, this argument must be used when no existing
-commandline switch alias is available for the desired type, as is the case
-with "error", "zero", "raid1", "raid4", "raid5", or "raid6".
-.TP
-.IR \fB\-T ", " \fB\-\-thin ", " \fB\-\-thinpool " " ThinPoolLogicalVolumeName [ Path ]
+.IR \fB\-T ", " \fB\-\-thin ", " \fB\-\-thinpool " " ThinPoolLogicalVolume { Name | Path }
Creates thin pool or thin logical volume or both.
Specifying the optional argument --size will cause the creation of
the thin pool logical volume.
@@ -294,7 +287,15 @@
thin pool and thin volume using this pool.
Requires device mapper kernel driver for thin provisioning
from kernel 3.2 or newer.
-
+.TP
+.B \-\-type \fISegmentType
+Create a logical volume that uses the specified segment type
+(e.g. "raid5", "mirror", "snapshot", "thin", "thin_pool").
+Many segment types have a
+commandline switch alias that will enable their use (-s is an alias for
+--type snapshot). However, this argument must be used when no existing
+commandline switch alias is available for the desired type, as is the case
+with "error", "zero", "raid1", "raid4", "raid5", or "raid6".
.TP
.IR \fB\-V ", " \fB\-\-virtualsize " " VirtualSize [ bBsSkKmMgGtTpPeE ]
Create a sparse device of the given size (in MB by default) using a snapshot
^ permalink raw reply [flat|nested] 10+ messages in thread
* LVM2/man lvcreate.8.in
@ 2011-11-07 10:59 zkabelac
0 siblings, 0 replies; 10+ messages in thread
From: zkabelac @ 2011-11-07 10:59 UTC (permalink / raw)
To: lvm-devel, lvm2-cvs
CVSROOT: /cvs/lvm2
Module name: LVM2
Changes by: zkabelac@sourceware.org 2011-11-07 10:59:56
Modified files:
man : lvcreate.8.in
Log message:
Thin lvcreate poolmetadatasize units doc
Patches:
http://sourceware.org/cgi-bin/cvsweb.cgi/LVM2/man/lvcreate.8.in.diff?cvsroot=lvm2&r1=1.30&r2=1.31
--- LVM2/man/lvcreate.8.in 2011/11/04 22:47:17 1.30
+++ LVM2/man/lvcreate.8.in 2011/11/07 10:59:55 1.31
@@ -93,7 +93,7 @@
.RB [ \-c | \-\-chunksize
.IR ChunkSize ]
.RB [ \-\-poolmetadatasize
-.IR MetadataSize [ bBsSkKmMgGt ]]]
+.IR MetadataSize [ bBsSkKmMgG ]]]
.RB [ \-\-thinpool
.IR ThinPoolLogicalVolumeName [ Path ]]
.RB [ \-V | \-\-virtualsize
@@ -240,6 +240,7 @@
Set the size of thin pool's metadata logical volume.
Supported value is in range between 2MiB and 16GiB.
Default value is (Pool_LV_size / Pool_LV_chunk_size * 64b).
+Default unit is megabytes.
.TP
.IR \fB\-r ", " \fB\-\-readahead " {" ReadAheadSectors | auto | none }
^ permalink raw reply [flat|nested] 10+ messages in thread
* LVM2/man lvcreate.8.in
@ 2011-11-04 22:47 zkabelac
0 siblings, 0 replies; 10+ messages in thread
From: zkabelac @ 2011-11-04 22:47 UTC (permalink / raw)
To: lvm-devel, lvm2-cvs
CVSROOT: /cvs/lvm2
Module name: LVM2
Changes by: zkabelac@sourceware.org 2011-11-04 22:47:17
Modified files:
man : lvcreate.8.in
Log message:
Thin lvcreate man update
Added poolmetadatasize options
Add an example.
Patches:
http://sourceware.org/cgi-bin/cvsweb.cgi/LVM2/man/lvcreate.8.in.diff?cvsroot=lvm2&r1=1.29&r2=1.30
--- LVM2/man/lvcreate.8.in 2011/10/30 22:08:21 1.29
+++ LVM2/man/lvcreate.8.in 2011/11/04 22:47:17 1.30
@@ -79,26 +79,27 @@
.br
.B lvcreate
+.BR \-T | \-\-thin
+.IR VolumeGroupName [ Path ][/ ThinPoolLogicalVolumeName
+.RB [{ \-l | \-\-extents
+.IR LogicalExtentsNumber [ % { VG | FREE | ORIGIN }]
+|
+.BR \-L | \-\-size
+.IR LogicalVolumeSize [ bBsSkKmMgGtTpPeE ]}
.RB [ \-i | \-\-stripes
.IR Stripes
.RB [ \-I | \-\-stripesize
.IR StripeSize ]]
-.RB [ \-l | \-\-extents
-.IR LogicalExtentsNumber [ % { VG | FREE | ORIGIN }]
-|
-.BR \-L | \-\-size
-.IR LogicalVolumeSize [ bBsSkKmMgGtTpPeE ]]
.RB [ \-c | \-\-chunksize
.IR ChunkSize ]
+.RB [ \-\-poolmetadatasize
+.IR MetadataSize [ bBsSkKmMgGt ]]]
+.RB [ \-\-thinpool
+.IR ThinPoolLogicalVolumeName [ Path ]]
.RB [ \-V | \-\-virtualsize
-.IR VirtualSize ]
+.IR VirtualSize [ bBsSkKmMgGtTpPeE ]]
.RB [ \-n | \-\-name
-.IR ThinLogicalVolumeName ]
-.RB [ \-T | \-\-thin
-.IR VolumeGroupName [/ ThinPoolLogicalVolumeName
-|
-.B \-\-thinpool
-.IR ThinPoolLogicalVolumeName ]]
+.IR ThinLogicalVolumeName [ Path ]]
.br
.SH DESCRIPTION
@@ -235,6 +236,12 @@
.br
Default is read and write.
.TP
+.IR \fB\-\-poolmetadatasize " " MetadataSize [ bBsSkKmMgG ]
+Set the size of thin pool's metadata logical volume.
+Supported value is in range between 2MiB and 16GiB.
+Default value is (Pool_LV_size / Pool_LV_chunk_size * 64b).
+
+.TP
.IR \fB\-r ", " \fB\-\-readahead " {" ReadAheadSectors | auto | none }
Set read ahead sector count of this logical volume.
For volume groups with metadata in lvm1 format, this must
@@ -269,17 +276,24 @@
.TP
.B \-\-type \fISegmentType
Create a logical volume that uses the specified segment type
-(e.g. "raid5", "mirror", "snapshot"). Many segment types have a
+(e.g. "raid5", "mirror", "snapshot", "thin", "thin_pool").
+Many segment types have a
commandline switch alias that will enable their use (-s is an alias for
--type snapshot). However, this argument must be used when no existing
commandline switch alias is available for the desired type, as is the case
with "error", "zero", "raid1", "raid4", "raid5", or "raid6".
.TP
-.BR \-T ", " \-\-thin " " \fIVolumeGroupName [/ \fIThinPoolLogicalVolumeName ]
-Defines the thin pool logical volume.
-.TP
-.BR \-\-thinpool " " \fIThinPoolLogicalVolumeName
-Specifies the thin pool logical volume.
+.IR \fB\-T ", " \fB\-\-thin ", " \fB\-\-thinpool " " ThinPoolLogicalVolumeName [ Path ]
+Creates thin pool or thin logical volume or both.
+Specifying the optional argument --size will cause the creation of
+the thin pool logical volume.
+Specifying the optional argument --virtualsize will cause the creation of
+the thin logical volume from given thin pool volume.
+Specifying both arguments will cause the creation of both
+thin pool and thin volume using this pool.
+Requires device mapper kernel driver for thin provisioning
+from kernel 3.2 or newer.
+
.TP
.IR \fB\-V ", " \fB\-\-virtualsize " " VirtualSize [ bBsSkKmMgGtTpPeE ]
Create a sparse device of the given size (in MB by default) using a snapshot
@@ -344,6 +358,12 @@
.sp
.B lvcreate --type raid5 -L 5G -i 3 -I 64 -n my_lv vg00
+Creates 100MiB pool logical volume for thin provisioning
+build with 2 stripes 64KiB and chunk size 128KiB together with
+1TiB thin provisioned logical volume "vg00/thin_lv".
+.sp
+.B lvcreate -i 2 -I 64 -c 256 -L100M -T vg00/pool -V 1T --name thin_lv
+
.SH SEE ALSO
.BR lvm (8),
.BR vgcreate (8),
^ permalink raw reply [flat|nested] 10+ messages in thread
* LVM2/man lvcreate.8.in
@ 2011-10-30 22:08 zkabelac
0 siblings, 0 replies; 10+ messages in thread
From: zkabelac @ 2011-10-30 22:08 UTC (permalink / raw)
To: lvm-devel, lvm2-cvs
CVSROOT: /cvs/lvm2
Module name: LVM2
Changes by: zkabelac@sourceware.org 2011-10-30 22:08:21
Modified files:
man : lvcreate.8.in
Log message:
More updates for lvcreate manpage
Patches:
http://sourceware.org/cgi-bin/cvsweb.cgi/LVM2/man/lvcreate.8.in.diff?cvsroot=lvm2&r1=1.28&r2=1.29
--- LVM2/man/lvcreate.8.in 2011/10/28 20:36:05 1.28
+++ LVM2/man/lvcreate.8.in 2011/10/30 22:08:21 1.29
@@ -42,7 +42,7 @@
.RB [ \-R | \-\-regionsize
.IR MirrorLogRegionSize ]]
.RB [ \-n | \-\-name
-.IR LogicalVolumeName ]
+.IR LogicalVolumeName [ Path ]]
.RB [ \-p | \-\-permission
.RI { r | rw }]
.RB [ \-r | \-\-readahead
@@ -53,11 +53,10 @@
.RB [ \-v | \-\-verbose ]
.RB [ \-Z | \-\-zero
.RI { y | n }]
-.IR VolumeGroupName
+.IR VolumeGroupName [ Path ]
.RI [ PhysicalVolumePath [ :PE [ -PE ]]...]
.br
-.br
.B lvcreate
.RB { \-l | \-\-extents
.IR LogicalExtentsNumber [ % { VG | FREE | ORIGIN }]
@@ -70,13 +69,13 @@
.RB [ \-\-ignoremonitoring ]
.RB [ \-\-monitor " {" \fIy | \fIn }]
.RB [ \-n | \-\-name
-.IR SnapshotLogicalVolumeName ]
+.IR SnapshotLogicalVolumeName [ Path ]]
.BR \-s | \-\-snapshot
-.RI [ OriginalLogicalVolumePath
+.RI [ OriginalLogicalVolume [ Path ]
|
-.IR VolumeGroupName
+.IR VolumeGroupName [ Path ]
.BR \-V | \-\-virtualsize
-.IR VirtualSize ]
+.IR VirtualSize [ bBsSkKmMgGtTpPeE ]]
.br
.B lvcreate
@@ -282,7 +281,7 @@
.BR \-\-thinpool " " \fIThinPoolLogicalVolumeName
Specifies the thin pool logical volume.
.TP
-.BR \-V ", " \-\-virtualsize " " \fIVirtualSize
+.IR \fB\-V ", " \fB\-\-virtualsize " " VirtualSize [ bBsSkKmMgGtTpPeE ]
Create a sparse device of the given size (in MB by default) using a snapshot
or thinly provisioned device when thin pool is specified.
Anything written to the device will be returned when reading from it.
^ permalink raw reply [flat|nested] 10+ messages in thread
* LVM2/man lvcreate.8.in
@ 2011-10-28 20:36 zkabelac
0 siblings, 0 replies; 10+ messages in thread
From: zkabelac @ 2011-10-28 20:36 UTC (permalink / raw)
To: lvm-devel, lvm2-cvs
CVSROOT: /cvs/lvm2
Module name: LVM2
Changes by: zkabelac@sourceware.org 2011-10-28 20:36:06
Modified files:
man : lvcreate.8.in
Log message:
Continue with lvcreate man page update
Already in WHATS_NEW.
Patches:
http://sourceware.org/cgi-bin/cvsweb.cgi/LVM2/man/lvcreate.8.in.diff?cvsroot=lvm2&r1=1.27&r2=1.28
--- LVM2/man/lvcreate.8.in 2011/10/28 20:33:50 1.27
+++ LVM2/man/lvcreate.8.in 2011/10/28 20:36:05 1.28
@@ -304,44 +304,46 @@
Warning: trying to mount an unzeroed logical volume can cause the system to
hang.
.SH Examples
-"lvcreate -i 3 -I 8 -L 100M vg00" tries to create a striped logical
-volume with 3 stripes, a stripesize of 8KB and a size of 100MB in the volume
-group named vg00. The logical volume name will be chosen by lvcreate.
-
-"lvcreate -m1 -L 500M vg00" tries to create a mirror logical volume
-with 2 sides with a useable size of 500 MiB. This operation would
-require 3 devices - two for the mirror devices and one for the disk
-log.
-
-"lvcreate -m1 --mirrorlog core -L 500M vg00" tries to create a mirror logical volume
-with 2 sides with a useable size of 500 MiB. This operation would
-require 2 devices - the log is "in-memory".
-
-"lvcreate --size 100m --snapshot --name snap /dev/vg00/lvol1"
-.br
-creates a snapshot logical volume named /dev/vg00/snap which has access to the
+Creates a striped logical volume with 3 stripes, a stripesize of 8KB
+and a size of 100MB in the volume group named vg00.
+The logical volume name will be chosen by lvcreate:
+.sp
+.B lvcreate -i 3 -I 8 -L 100M vg00
+
+Creates a mirror logical volume with 2 sides with a useable size of 500 MiB.
+This operation would require 3 devices (or option --alloc anywhere) - two
+for the mirror devices and one for the disk log.
+.sp
+.B lvcreate -m1 -L 500M vg00
+
+Creates a mirror logical volume with 2 sides with a useable size of 500 MiB.
+This operation would require 2 devices - the log is "in-memory".
+.sp
+.B lvcreate -m1 --mirrorlog core -L 500M vg00
+
+Creates a snapshot logical volume named /dev/vg00/snap which has access to the
contents of the original logical volume named /dev/vg00/lvol1
at snapshot logical volume creation time. If the original logical volume
contains a file system, you can mount the snapshot logical volume on an
arbitrary directory in order to access the contents of the filesystem to run
a backup while the original filesystem continues to get updated.
+.sp
+.B lvcreate --size 100m --snapshot --name snap /dev/vg00/lvol1
-"lvcreate --virtualsize 1T --size 100M --snapshot --name sparse vg1"
-.br
-creates a sparse device named /dev/vg1/sparse of size 1TB with space for just
+Creates a sparse device named /dev/vg1/sparse of size 1TB with space for just
under 100MB of actual data on it.
-.br
+.sp
+.B lvcreate --virtualsize 1T --size 100M --snapshot --name sparse vg1
-"lvcreate -L 64M -n lvol1 vg00 /dev/sda:0-7 /dev/sdb:0-7"
-.br
-creates a linear logical volume "vg00/lvol1" using physical extents
+Creates a linear logical volume "vg00/lvol1" using physical extents
/dev/sda:0-7 and /dev/sdb:0-7 for allocation of extents.
-.br
+.sp
+.B lvcreate -L 64M -n lvol1 vg00 /dev/sda:0-7 /dev/sdb:0-7
-"lvcreate --type raid5 -L 5G -i 3 -I 64 -n my_lv vg00"
-.br
-creates a 5GiB RAID5 logical volume "vg00/my_lv", with 3 stripes (plus
+Creates a 5GiB RAID5 logical volume "vg00/my_lv", with 3 stripes (plus
a parity drive for a total of 4 devices) and a stripesize of 64kiB.
+.sp
+.B lvcreate --type raid5 -L 5G -i 3 -I 64 -n my_lv vg00
.SH SEE ALSO
.BR lvm (8),
^ permalink raw reply [flat|nested] 10+ messages in thread
* LVM2/man lvcreate.8.in
@ 2011-10-28 20:33 zkabelac
0 siblings, 0 replies; 10+ messages in thread
From: zkabelac @ 2011-10-28 20:33 UTC (permalink / raw)
To: lvm-devel, lvm2-cvs
CVSROOT: /cvs/lvm2
Module name: LVM2
Changes by: zkabelac@sourceware.org 2011-10-28 20:33:50
Modified files:
man : lvcreate.8.in
Log message:
Thin option documentation
Patches:
http://sourceware.org/cgi-bin/cvsweb.cgi/LVM2/man/lvcreate.8.in.diff?cvsroot=lvm2&r1=1.26&r2=1.27
--- LVM2/man/lvcreate.8.in 2011/10/25 13:24:23 1.26
+++ LVM2/man/lvcreate.8.in 2011/10/28 20:33:50 1.27
@@ -80,19 +80,26 @@
.br
.B lvcreate
+.RB [ \-i | \-\-stripes
+.IR Stripes
+.RB [ \-I | \-\-stripesize
+.IR StripeSize ]]
.RB [ \-l | \-\-extents
.IR LogicalExtentsNumber [ % { VG | FREE | ORIGIN }]
|
.BR \-L | \-\-size
.IR LogicalVolumeSize [ bBsSkKmMgGtTpPeE ]]
+.RB [ \-c | \-\-chunksize
+.IR ChunkSize ]
.RB [ \-V | \-\-virtualsize
.IR VirtualSize ]
.RB [ \-n | \-\-name
.IR ThinLogicalVolumeName ]
-.RB [ \-\-thinpool
-.IR ThinPoolLogicalVolumeName ]
-.B \-T
-.IR VolumeGroupName [/ ThinPoolLogicalVolumeName ]
+.RB [ \-T | \-\-thin
+.IR VolumeGroupName [/ ThinPoolLogicalVolumeName
+|
+.B \-\-thinpool
+.IR ThinPoolLogicalVolumeName ]]
.br
.SH DESCRIPTION
@@ -269,11 +276,18 @@
commandline switch alias is available for the desired type, as is the case
with "error", "zero", "raid1", "raid4", "raid5", or "raid6".
.TP
+.BR \-T ", " \-\-thin " " \fIVolumeGroupName [/ \fIThinPoolLogicalVolumeName ]
+Defines the thin pool logical volume.
+.TP
+.BR \-\-thinpool " " \fIThinPoolLogicalVolumeName
+Specifies the thin pool logical volume.
+.TP
.BR \-V ", " \-\-virtualsize " " \fIVirtualSize
-Create a sparse device of the given size (in MB by default) using a snapshot.
+Create a sparse device of the given size (in MB by default) using a snapshot
+or thinly provisioned device when thin pool is specified.
Anything written to the device will be returned when reading from it.
Reading from other areas of the device will return blocks of zeros.
-It is implemented by creating a hidden virtual device of the
+Virtual snapshot is implemented by creating a hidden virtual device of the
requested size using the zero target. A suffix of _vorigin is used for
this device.
.TP
^ permalink raw reply [flat|nested] 10+ messages in thread
* LVM2/man lvcreate.8.in
@ 2009-09-29 15:11 wysochanski
0 siblings, 0 replies; 10+ messages in thread
From: wysochanski @ 2009-09-29 15:11 UTC (permalink / raw)
To: lvm-devel, lvm2-cvs
CVSROOT: /cvs/lvm2
Module name: LVM2
Changes by: wysochanski@sourceware.org 2009-09-29 15:11:06
Modified files:
man : lvcreate.8.in
Log message:
Trivial cleanup to lvcreate man page - use virtualsize in example.
virtualsize replaced virtualoriginsize but the example was never updated.
Patches:
http://sourceware.org/cgi-bin/cvsweb.cgi/LVM2/man/lvcreate.8.in.diff?cvsroot=lvm2&r1=1.10&r2=1.11
--- LVM2/man/lvcreate.8.in 2009/08/10 17:23:04 1.10
+++ LVM2/man/lvcreate.8.in 2009/09/29 15:11:06 1.11
@@ -205,7 +205,7 @@
arbitrary directory in order to access the contents of the filesystem to run
a backup while the original filesystem continues to get updated.
-"lvcreate --virtualoriginsize 1T --size 100M --snapshot --name sparse vg1"
+"lvcreate --virtualsize 1T --size 100M --snapshot --name sparse vg1"
.br
creates a sparse device named /dev/vg1/sparse of size 1TB with space for just
under 100MB of actual data on it.
^ permalink raw reply [flat|nested] 10+ messages in thread
end of thread, other threads:[~2012-01-20 10:50 UTC | newest]
Thread overview: 10+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2012-01-20 10:50 LVM2/man lvcreate.8.in zkabelac
-- strict thread matches above, loose matches on Subject: below --
2011-12-21 13:58 zkabelac
2011-11-10 12:41 zkabelac
2011-11-08 12:12 zkabelac
2011-11-07 10:59 zkabelac
2011-11-04 22:47 zkabelac
2011-10-30 22:08 zkabelac
2011-10-28 20:36 zkabelac
2011-10-28 20:33 zkabelac
2009-09-29 15:11 wysochanski
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).