mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-30 17:18:21 +03:00
8f37c22df2
Update lvresize options with +/-.
2459 lines
60 KiB
Plaintext
2459 lines
60 KiB
Plaintext
.TH LVCREATE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
|
|
.
|
|
.SH NAME
|
|
.
|
|
lvcreate \(em Create a logical volume
|
|
.
|
|
.SH SYNOPSIS
|
|
.
|
|
\fBlvcreate\fP \fIoption_args\fP \fIposition_args\fP
|
|
.br
|
|
[ \fIoption_args\fP ]
|
|
.br
|
|
[ \fIposition_args\fP ]
|
|
.br
|
|
.P
|
|
.ad l
|
|
\fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP
|
|
.br
|
|
\fB--addtag\fP \fITag\fP
|
|
.br
|
|
\fB--alloc\fP \c
|
|
.nh
|
|
\%\fBcontiguous\fP|\:\fBcling\fP|\:\fBcling_by_tags\fP|\:\fBnormal\fP|\:\fBanywhere\fP|\:\fBinherit\fP
|
|
.hy
|
|
.br
|
|
\fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
\fB-H\fP|\fB--cache\fP
|
|
.br
|
|
\fB--cachedevice\fP \fIPV\fP
|
|
.br
|
|
\fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP
|
|
.br
|
|
\fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP
|
|
.br
|
|
\fB--cachepolicy\fP \fIString\fP
|
|
.br
|
|
\fB--cachepool\fP \fILV\fP
|
|
.br
|
|
\fB--cachesettings\fP \fIString\fP
|
|
.br
|
|
\fB--cachesize\fP \fISize\fP[m|UNIT]
|
|
.br
|
|
\fB--cachevol\fP \fILV\fP
|
|
.br
|
|
\fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT]
|
|
.br
|
|
\fB--commandprofile\fP \fIString\fP
|
|
.br
|
|
\fB--compression\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
\fB--config\fP \fIString\fP
|
|
.br
|
|
\fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
\fB-d\fP|\fB--debug\fP
|
|
.br
|
|
\fB--deduplication\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
\fB--devices\fP \fIPV\fP
|
|
.br
|
|
\fB--devicesfile\fP \fIString\fP
|
|
.br
|
|
\fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP
|
|
.br
|
|
\fB--driverloaded\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
\fB--errorwhenfull\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
\fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT]
|
|
.br
|
|
\fB-h\fP|\fB--help\fP
|
|
.br
|
|
\fB-K\fP|\fB--ignoreactivationskip\fP
|
|
.br
|
|
\fB--ignoremonitoring\fP
|
|
.br
|
|
\fB--journal\fP \fIString\fP
|
|
.br
|
|
\fB--lockopt\fP \fIString\fP
|
|
.br
|
|
\fB--longhelp\fP
|
|
.br
|
|
\fB-j\fP|\fB--major\fP \fINumber\fP
|
|
.br
|
|
\fB--\fP[\fBraid\fP]\fBmaxrecoveryrate\fP \fISize\fP[k|UNIT]
|
|
.br
|
|
\fB--metadataprofile\fP \fIString\fP
|
|
.br
|
|
\fB--minor\fP \fINumber\fP
|
|
.br
|
|
\fB--\fP[\fBraid\fP]\fBminrecoveryrate\fP \fISize\fP[k|UNIT]
|
|
.br
|
|
\fB--mirrorlog\fP \fBcore\fP|\fBdisk\fP
|
|
.br
|
|
\fB-m\fP|\fB--mirrors\fP \fINumber\fP
|
|
.br
|
|
\fB--monitor\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
\fB-n\fP|\fB--name\fP \fIString\fP
|
|
.br
|
|
\fB--nohints\fP
|
|
.br
|
|
\fB--nolocking\fP
|
|
.br
|
|
\fB--nosync\fP
|
|
.br
|
|
\fB--noudevsync\fP
|
|
.br
|
|
\fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP
|
|
.br
|
|
\fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
\fB--pooldatavdo\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
\fB--poolmetadatasize\fP \fISize\fP[m|UNIT]
|
|
.br
|
|
\fB--poolmetadataspare\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
\fB--profile\fP \fIString\fP
|
|
.br
|
|
\fB-q\fP|\fB--quiet\fP
|
|
.br
|
|
\fB--raidintegrity\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
\fB--raidintegrityblocksize\fP \fINumber\fP
|
|
.br
|
|
\fB--raidintegritymode\fP \fIString\fP
|
|
.br
|
|
\fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP
|
|
.br
|
|
\fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT]
|
|
.br
|
|
\fB--reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP
|
|
.br
|
|
\fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
\fB--setautoactivation\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
\fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT]
|
|
.br
|
|
\fB-s\fP|\fB--snapshot\fP
|
|
.br
|
|
\fB-i\fP|\fB--stripes\fP \fINumber\fP
|
|
.br
|
|
\fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT]
|
|
.br
|
|
\fB-t\fP|\fB--test\fP
|
|
.br
|
|
\fB-T\fP|\fB--thin\fP
|
|
.br
|
|
\fB--thinpool\fP \fILV\fP
|
|
.br
|
|
\fB--type\fP \c
|
|
.nh
|
|
\%\fBlinear\fP|\:\fBstriped\fP|\:\fBsnapshot\fP|\:\fBraid\fP|\:\fBmirror\fP|\:\fBthin\fP|\:\fBthin-pool\fP|\:\fBvdo\fP|\:\fBvdo-pool\fP|\:\fBcache\fP|\:\fBcache-pool\fP|\:\fBwritecache\fP
|
|
.hy
|
|
.br
|
|
\fB--vdo\fP
|
|
.br
|
|
\fB--vdopool\fP \fILV\fP
|
|
.br
|
|
\fB--vdosettings\fP \fIString\fP
|
|
.br
|
|
\fB-v\fP|\fB--verbose\fP
|
|
.br
|
|
\fB--version\fP
|
|
.br
|
|
\fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT]
|
|
.br
|
|
\fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
\fB-y\fP|\fB--yes\fP
|
|
.br
|
|
\fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP
|
|
.ad b
|
|
.
|
|
.SH DESCRIPTION
|
|
.
|
|
lvcreate creates a new LV in a VG. For standard LVs, this requires
|
|
allocating logical extents from the VG's free physical extents. If there
|
|
is not enough free space, the VG can be extended with other PVs
|
|
(\fBvgextend\fP(8)), or existing LVs can be reduced or removed
|
|
(\fBlvremove\fP(8), \fBlvreduce\fP(8)).
|
|
.P
|
|
To control which PVs a new LV will use, specify one or more PVs as
|
|
position args at the end of the command line. lvcreate will allocate
|
|
physical extents only from the specified PVs.
|
|
.P
|
|
lvcreate can also create snapshots of existing LVs, e.g. for backup
|
|
purposes. The data in a new snapshot LV represents the content of the
|
|
original LV from the time the snapshot was created.
|
|
.P
|
|
RAID LVs can be created by specifying an LV type when creating the LV (see
|
|
\fBlvmraid\fP(7)). Different RAID levels require different numbers of
|
|
unique PVs be available in the VG for allocation.
|
|
.P
|
|
Thin pools (for thin provisioning) and cache pools (for caching) are
|
|
represented by special LVs with types thin-pool and cache-pool (see
|
|
\fBlvmthin\fP(7) and \fBlvmcache\fP(7)). The pool LVs are not usable as
|
|
standard block devices, but the LV names act as references to the pools.
|
|
.P
|
|
Thin LVs are thinly provisioned from a thin pool, and are created with a
|
|
virtual size rather than a physical size. A cache LV is the combination of
|
|
a standard LV with a cache pool, used to cache active portions of the LV
|
|
to improve performance.
|
|
.P
|
|
VDO LVs are also provisioned volumes from a VDO pool, and are created with a
|
|
virtual size rather than a physical size (see \fBlvmvdo\fP(7)).
|
|
.P
|
|
.SS Usage notes
|
|
In the usage section below, \fB--size\fP \fISize\fP can be replaced
|
|
with \fB--extents\fP \fINumber\fP. See descriptions in the options section.
|
|
.P
|
|
In the usage section below, \fB--name\fP is omitted from the required
|
|
options, even though it is typically used. When the name is not
|
|
specified, a new LV name is generated with the "lvol" prefix and a unique
|
|
numeric suffix.
|
|
.P
|
|
In the usage section below, when creating a pool and the name is omitted
|
|
the new LV pool name is generated with the
|
|
"vpool" for vdo-pools for prefix and a unique numeric suffix.
|
|
.P
|
|
Pool name can be specified together with \fIVG\fP name i.e.:
|
|
vg00/mythinpool.
|
|
.
|
|
.SH USAGE
|
|
.
|
|
Create a linear LV.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB--type linear\fP ] (implied)
|
|
.br
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a striped LV.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB-i\fP|\fB--stripes\fP \fINumber\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB--type striped\fP ] (implied)
|
|
.br
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a raid1 or mirror LV.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB-m\fP|\fB--mirrors\fP \fINumber\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB--type raid1\fP|\fBmirror\fP ] (implied)
|
|
.br
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--mirrorlog\fP \fBcore\fP|\fBdisk\fP ]
|
|
.br
|
|
[ \fB--\fP[\fBraid\fP]\fBminrecoveryrate\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--\fP[\fBraid\fP]\fBmaxrecoveryrate\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--raidintegrity\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--raidintegritymode\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--raidintegrityblocksize\fP \fINumber\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a raid LV (a specific raid level must be used, e.g. raid1).
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBraid\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-m\fP|\fB--mirrors\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--\fP[\fBraid\fP]\fBminrecoveryrate\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--\fP[\fBraid\fP]\fBmaxrecoveryrate\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--raidintegrity\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--raidintegritymode\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--raidintegrityblocksize\fP \fINumber\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a raid10 LV.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB-m\fP|\fB--mirrors\fP \fINumber\fP \fB-i\fP|\fB--stripes\fP \fINumber\fP
|
|
.RS 5
|
|
\fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP
|
|
.RE
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB--type raid10\fP ] (implied)
|
|
.br
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--\fP[\fBraid\fP]\fBminrecoveryrate\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--\fP[\fBraid\fP]\fBmaxrecoveryrate\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--raidintegrity\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--raidintegritymode\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--raidintegrityblocksize\fP \fINumber\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a COW snapshot LV of an origin LV.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB-s\fP|\fB--snapshot\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fILV\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB--type snapshot\fP ] (implied)
|
|
.br
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a thin pool.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBthin-pool\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-T\fP|\fB--thin\fP ]
|
|
.br
|
|
[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--thinpool\fP \fILV\fP\fI_new\fP ]
|
|
.br
|
|
[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ]
|
|
.br
|
|
[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--pooldatavdo\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--compression\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--deduplication\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--vdosettings\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a cache pool.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBcache-pool\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-H\fP|\fB--cache\fP ]
|
|
.br
|
|
[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ]
|
|
.br
|
|
[ \fB--cachepolicy\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--cachesettings\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ]
|
|
.br
|
|
[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a thin LV in a thin pool.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] \fB--thinpool\fP \fILV\fP \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB--type thin\fP ] (implied)
|
|
.br
|
|
.br
|
|
[ \fB-T\fP|\fB--thin\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a thin LV that is a snapshot of an existing thin LV.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB-s\fP|\fB--snapshot\fP \fILV1\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB--type thin\fP ] (implied)
|
|
.br
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.P
|
|
.RS 4
|
|
LV1 types: thin
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a thin LV that is a snapshot of an external origin LV.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBthin\fP \fB--thinpool\fP \fILV\fP \fILV\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-T\fP|\fB--thin\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a LV that returns VDO when used.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBvdo\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--vdo\fP ]
|
|
.br
|
|
[ \fB--vdopool\fP \fILV\fP\fI_new\fP ]
|
|
.br
|
|
[ \fB--compression\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--deduplication\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--vdosettings\fP \fIString\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a new LV, then attach the specified cachepool
|
|
.br
|
|
which converts the new LV to type cache.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBcache\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT]
|
|
.RS 5
|
|
\fB--cachepool\fP \fILV\fP \fIVG\fP
|
|
.RE
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-H\fP|\fB--cache\fP ]
|
|
.br
|
|
[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ]
|
|
.br
|
|
[ \fB--cachepolicy\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--cachesettings\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ]
|
|
.br
|
|
[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a new LV, then attach the specified cachevol
|
|
.br
|
|
which converts the new LV to type cache.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBcache\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT]
|
|
.RS 5
|
|
\fB--cachevol\fP \fILV\fP \fIVG\fP
|
|
.RE
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ]
|
|
.br
|
|
[ \fB--cachepolicy\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--cachesettings\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a new LV, then attach a cachevol created from
|
|
.br
|
|
the specified cache device, which converts the
|
|
.br
|
|
new LV to type cache.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBcache\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT]
|
|
.RS 5
|
|
\fB--cachedevice\fP \fIPV\fP \fIVG\fP
|
|
.RE
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--cachesize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ]
|
|
.br
|
|
[ \fB--cachepolicy\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--cachesettings\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a new LV, then attach the specified cachevol
|
|
.br
|
|
which converts the new LV to type writecache.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBwritecache\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT]
|
|
.RS 5
|
|
\fB--cachevol\fP \fILV\fP \fIVG\fP
|
|
.RE
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--cachesettings\fP \fIString\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a new LV, then attach a cachevol created from
|
|
.br
|
|
the specified cache device, which converts the
|
|
.br
|
|
new LV to type writecache.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBwritecache\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT]
|
|
.RS 5
|
|
\fB--cachedevice\fP \fIPV\fP \fIVG\fP
|
|
.RE
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--cachesize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--cachesettings\fP \fIString\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Common options for command:
|
|
.
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ]
|
|
.br
|
|
[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB-K\fP|\fB--ignoreactivationskip\fP ]
|
|
.br
|
|
[ \fB-j\fP|\fB--major\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-n\fP|\fB--name\fP \fIString\fP ]
|
|
.br
|
|
[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ]
|
|
.br
|
|
[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ]
|
|
.br
|
|
[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--addtag\fP \fITag\fP ]
|
|
.br
|
|
[ \fB--alloc\fP \c
|
|
.nh
|
|
\%\fBcontiguous\fP|\:\fBcling\fP|\:\fBcling_by_tags\fP|\:\fBnormal\fP|\:\fBanywhere\fP|\:\fBinherit\fP
|
|
.hy
|
|
]
|
|
.br
|
|
[ \fB--ignoremonitoring\fP ]
|
|
.br
|
|
[ \fB--metadataprofile\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--minor\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB--monitor\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--nosync\fP ]
|
|
.br
|
|
[ \fB--noudevsync\fP ]
|
|
.br
|
|
[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP ]
|
|
.br
|
|
[ \fB--setautoactivation\fP \fBy\fP|\fBn\fP ]
|
|
.ad b
|
|
.RE
|
|
.P
|
|
Common options for lvm:
|
|
.
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-d\fP|\fB--debug\fP ]
|
|
.br
|
|
[ \fB-h\fP|\fB--help\fP ]
|
|
.br
|
|
[ \fB-q\fP|\fB--quiet\fP ]
|
|
.br
|
|
[ \fB-t\fP|\fB--test\fP ]
|
|
.br
|
|
[ \fB-v\fP|\fB--verbose\fP ]
|
|
.br
|
|
[ \fB-y\fP|\fB--yes\fP ]
|
|
.br
|
|
[ \fB--commandprofile\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--config\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--devices\fP \fIPV\fP ]
|
|
.br
|
|
[ \fB--devicesfile\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--journal\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--lockopt\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--longhelp\fP ]
|
|
.br
|
|
[ \fB--nohints\fP ]
|
|
.br
|
|
[ \fB--nolocking\fP ]
|
|
.br
|
|
[ \fB--profile\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--version\fP ]
|
|
.ad b
|
|
.RE
|
|
.
|
|
.SH OPTIONS
|
|
.
|
|
.
|
|
.HP
|
|
\fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP
|
|
.br
|
|
Controls the active state of the new LV.
|
|
\fBy\fP makes the LV active, or available.
|
|
New LVs are made active by default.
|
|
\fBn\fP makes the LV inactive, or unavailable, only when possible.
|
|
In some cases, creating an LV requires it to be active.
|
|
For example, COW snapshots of an active origin LV can only
|
|
be created in the active state (this does not apply to thin snapshots).
|
|
The --zero option normally requires the LV to be active.
|
|
If autoactivation \fBay\fP is used, the LV is only activated
|
|
if it matches an item in \fBlvm.conf\fP(5) \fBactivation/auto_activation_volume_list\fP.
|
|
\fBay\fP implies --zero n and --wipesignatures n.
|
|
See \fBlvmlockd\fP(8) for more information about activation options for shared VGs.
|
|
.
|
|
.HP
|
|
\fB--addtag\fP \fITag\fP
|
|
.br
|
|
Adds a tag to a PV, VG or LV. This option can be repeated to add
|
|
multiple tags at once. See \fBlvm\fP(8) for information about tags.
|
|
.
|
|
.HP
|
|
.ad l
|
|
\fB--alloc\fP \c
|
|
.nh
|
|
\%\fBcontiguous\fP|\:\fBcling\fP|\:\fBcling_by_tags\fP|\:\fBnormal\fP|\:\fBanywhere\fP|\:\fBinherit\fP
|
|
.hy
|
|
.ad b
|
|
.br
|
|
Determines the allocation policy when a command needs to allocate
|
|
Physical Extents (PEs) from the VG. Each VG and LV has an allocation policy
|
|
which can be changed with vgchange/lvchange, or overridden on the
|
|
command line.
|
|
\fBnormal\fP applies common sense rules such as not placing parallel stripes
|
|
on the same PV.
|
|
\fBinherit\fP applies the VG policy to an LV.
|
|
\fBcontiguous\fP requires new PEs be placed adjacent to existing PEs.
|
|
\fBcling\fP places new PEs on the same PV as existing PEs in the same
|
|
stripe of the LV.
|
|
If there are sufficient PEs for an allocation, but normal does not
|
|
use them, \fBanywhere\fP will use them even if it reduces performance,
|
|
e.g. by placing two stripes on the same PV.
|
|
Optional positional PV args on the command line can also be used to limit
|
|
which PVs the command will use for allocation.
|
|
See \fBlvm\fP(8) for more information about allocation.
|
|
.
|
|
.HP
|
|
\fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
Specifies if metadata should be backed up automatically after a change.
|
|
Enabling this is strongly advised! See \fBvgcfgbackup\fP(8) for more information.
|
|
.
|
|
.HP
|
|
\fB-H\fP|\fB--cache\fP
|
|
.br
|
|
Specifies the command is handling a cache LV or cache pool.
|
|
See --type cache and --type cache-pool.
|
|
See \fBlvmcache\fP(7) for more information about LVM caching.
|
|
.
|
|
.HP
|
|
\fB--cachedevice\fP \fIPV\fP
|
|
.br
|
|
The name of a device to use for a cache.
|
|
.
|
|
.HP
|
|
\fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP
|
|
.br
|
|
Specifies the cache metadata format used by cache target.
|
|
.
|
|
.HP
|
|
\fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP
|
|
.br
|
|
Specifies when writes to a cache LV should be considered complete.
|
|
\fBwriteback\fP considers a write complete as soon as it is
|
|
stored in the cache pool.
|
|
\fBwritethough\fP considers a write complete only when it has
|
|
been stored in both the cache pool and on the origin LV.
|
|
While writethrough may be slower for writes, it is more
|
|
resilient if something should happen to a device associated with the
|
|
cache pool LV. With \fBpassthrough\fP, all reads are served
|
|
from the origin LV (all reads miss the cache) and all writes are
|
|
forwarded to the origin LV; additionally, write hits cause cache
|
|
block invalidates. See \fBlvmcache\fP(7) for more information.
|
|
.
|
|
.HP
|
|
\fB--cachepolicy\fP \fIString\fP
|
|
.br
|
|
Specifies the cache policy for a cache LV.
|
|
See \fBlvmcache\fP(7) for more information.
|
|
.
|
|
.HP
|
|
\fB--cachepool\fP \fILV\fP
|
|
.br
|
|
The name of a cache pool.
|
|
.
|
|
.HP
|
|
\fB--cachesettings\fP \fIString\fP
|
|
.br
|
|
Specifies tunable kernel options for dm-cache or dm-writecache LVs.
|
|
Use the form 'option=value' or 'option1=value option2=value', or
|
|
repeat --cachesettings for each option being set.
|
|
These settings override the default kernel behaviors which are
|
|
usually adequate. To remove cachesettings and revert to the default
|
|
kernel behaviors, use --cachesettings 'default' for dm-cache or
|
|
an empty string --cachesettings '' for dm-writecache.
|
|
See \fBlvmcache\fP(7) for more information.
|
|
.
|
|
.HP
|
|
\fB--cachesize\fP \fISize\fP[m|UNIT]
|
|
.br
|
|
The size of cache to use.
|
|
.
|
|
.HP
|
|
\fB--cachevol\fP \fILV\fP
|
|
.br
|
|
The name of a cache volume.
|
|
.
|
|
.HP
|
|
\fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT]
|
|
.br
|
|
The size of chunks in a snapshot, cache pool or thin pool.
|
|
For snapshots, the value must be a power of 2 between 4 KiB and 512 KiB
|
|
and the default value is 4.
|
|
For a cache pool the value must be between 32 KiB and 1 GiB
|
|
and the default value is 64.
|
|
For a thin pool the value must be between 64 KiB and 1 GiB
|
|
and the default value starts with 64 and scales up to fit the
|
|
pool metadata size within 128 MiB, if the pool metadata size is not specified.
|
|
The value must be a multiple of 64 KiB.
|
|
See \fBlvmthin\fP(7) and \fBlvmcache\fP(7) for more information.
|
|
.
|
|
.HP
|
|
\fB--commandprofile\fP \fIString\fP
|
|
.br
|
|
The command profile to use for command configuration.
|
|
See \fBlvm.conf\fP(5) for more information about profiles.
|
|
.
|
|
.HP
|
|
\fB--compression\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
Controls whether compression is enabled or disable for VDO volume.
|
|
See \fBlvmvdo\fP(7) for more information about VDO usage.
|
|
.
|
|
.HP
|
|
\fB--config\fP \fIString\fP
|
|
.br
|
|
Config settings for the command. These override \fBlvm.conf\fP(5) settings.
|
|
The String arg uses the same format as \fBlvm.conf\fP(5),
|
|
or may use section/field syntax.
|
|
See \fBlvm.conf\fP(5) for more information about config.
|
|
.
|
|
.HP
|
|
\fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
Sets or resets the contiguous allocation policy for LVs.
|
|
Default is no contiguous allocation based on a next free principle.
|
|
It is only possible to change a non-contiguous allocation policy
|
|
to contiguous if all of the allocated physical extents in the LV
|
|
are already contiguous.
|
|
.
|
|
.HP
|
|
\fB-d\fP|\fB--debug\fP ...
|
|
.br
|
|
Set debug level. Repeat from 1 to 6 times to increase the detail of
|
|
messages sent to the log file and/or syslog (if configured).
|
|
.
|
|
.HP
|
|
\fB--deduplication\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
Controls whether deduplication is enabled or disable for VDO volume.
|
|
See \fBlvmvdo\fP(7) for more information about VDO usage.
|
|
.
|
|
.HP
|
|
\fB--devices\fP \fIPV\fP
|
|
.br
|
|
Restricts the devices that are visible and accessible to the command.
|
|
Devices not listed will appear to be missing. This option can be
|
|
repeated, or accepts a comma separated list of devices. This overrides
|
|
the devices file.
|
|
.
|
|
.HP
|
|
\fB--devicesfile\fP \fIString\fP
|
|
.br
|
|
A file listing devices that LVM should use.
|
|
The file must exist in \fI#DEFAULT_SYS_DIR#/devices/\fP and is managed
|
|
with the \fBlvmdevices\fP(8) command.
|
|
This overrides the \fBlvm.conf\fP(5) \fBdevices/devicesfile\fP and
|
|
\fBdevices/use_devicesfile\fP settings.
|
|
.
|
|
.HP
|
|
\fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP
|
|
.br
|
|
Specifies how the device-mapper thin pool layer in the kernel should
|
|
handle discards.
|
|
\fBignore\fP causes the thin pool to ignore discards.
|
|
\fBnopassdown\fP causes the thin pool to process discards itself to
|
|
allow reuse of unneeded extents in the thin pool.
|
|
\fBpassdown\fP causes the thin pool to process discards itself
|
|
(like nopassdown) and pass the discards to the underlying device.
|
|
See \fBlvmthin\fP(7) for more information.
|
|
.
|
|
.HP
|
|
\fB--driverloaded\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
If set to no, the command will not attempt to use device-mapper.
|
|
For testing and debugging.
|
|
.
|
|
.HP
|
|
\fB--errorwhenfull\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
Specifies thin pool behavior when data space is exhausted.
|
|
When yes, device-mapper will immediately return an error
|
|
when a thin pool is full and an I/O request requires space.
|
|
When no, device-mapper will queue these I/O requests for a
|
|
period of time to allow the thin pool to be extended.
|
|
Errors are returned if no space is available after the timeout.
|
|
(Also see dm-thin-pool kernel module option no_space_timeout.)
|
|
See \fBlvmthin\fP(7) for more information.
|
|
.
|
|
.HP
|
|
\fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT]
|
|
.br
|
|
Specifies the size of the new LV in logical extents.
|
|
The --size and --extents options are alternate methods of specifying size.
|
|
The total number of physical extents used will be
|
|
greater when redundant data is needed for RAID levels.
|
|
An alternate syntax allows the size to be determined indirectly
|
|
as a percentage of the size of a related VG, LV, or set of PVs. The
|
|
suffix \fB%VG\fP denotes the total size of the VG, the suffix \fB%FREE\fP
|
|
the remaining free space in the VG, and the suffix \fB%PVS\fP the free
|
|
space in the specified PVs. For a snapshot, the size
|
|
can be expressed as a percentage of the total size of the origin LV
|
|
with the suffix \fB%ORIGIN\fP (\fB100%ORIGIN\fP provides space for
|
|
the whole origin).
|
|
When expressed as a percentage, the size defines an upper limit for the
|
|
number of logical extents in the new LV. The precise number of logical
|
|
extents in the new LV is not determined until the command has completed.
|
|
.
|
|
.HP
|
|
\fB-h\fP|\fB--help\fP
|
|
.br
|
|
Display help text.
|
|
.
|
|
.HP
|
|
\fB-K\fP|\fB--ignoreactivationskip\fP
|
|
.br
|
|
Ignore the "activation skip" LV flag during activation
|
|
to allow LVs with the flag set to be activated.
|
|
.
|
|
.HP
|
|
\fB--ignoremonitoring\fP
|
|
.br
|
|
Do not interact with dmeventd unless --monitor is specified.
|
|
Do not use this if dmeventd is already monitoring a device.
|
|
.
|
|
.HP
|
|
\fB--journal\fP \fIString\fP
|
|
.br
|
|
Record information in the systemd journal.
|
|
This information is in addition to information
|
|
enabled by the lvm.conf log/journal setting.
|
|
command: record information about the command.
|
|
output: record the default command output.
|
|
debug: record full command debugging.
|
|
.
|
|
.HP
|
|
\fB--lockopt\fP \fIString\fP
|
|
.br
|
|
Used to pass options for special cases to lvmlockd.
|
|
See \fBlvmlockd\fP(8) for more information.
|
|
.
|
|
.HP
|
|
\fB--longhelp\fP
|
|
.br
|
|
Display long help text.
|
|
.
|
|
.HP
|
|
\fB-j\fP|\fB--major\fP \fINumber\fP
|
|
.br
|
|
Sets the major number of an LV block device.
|
|
.
|
|
.HP
|
|
\fB--\fP[\fBraid\fP]\fBmaxrecoveryrate\fP \fISize\fP[k|UNIT]
|
|
.br
|
|
Sets the maximum recovery rate for a RAID LV. The rate value
|
|
is an amount of data per second for each device in the array.
|
|
Setting the rate to 0 means it will be unbounded.
|
|
See \fBlvmraid\fP(7) for more information.
|
|
.
|
|
.HP
|
|
\fB--metadataprofile\fP \fIString\fP
|
|
.br
|
|
The metadata profile to use for command configuration.
|
|
See \fBlvm.conf\fP(5) for more information about profiles.
|
|
.
|
|
.HP
|
|
\fB--minor\fP \fINumber\fP
|
|
.br
|
|
Sets the minor number of an LV block device.
|
|
.
|
|
.HP
|
|
\fB--\fP[\fBraid\fP]\fBminrecoveryrate\fP \fISize\fP[k|UNIT]
|
|
.br
|
|
Sets the minimum recovery rate for a RAID LV. The rate value
|
|
is an amount of data per second for each device in the array.
|
|
Setting the rate to 0 means it will be unbounded.
|
|
See \fBlvmraid\fP(7) for more information.
|
|
.
|
|
.HP
|
|
\fB--mirrorlog\fP \fBcore\fP|\fBdisk\fP
|
|
.br
|
|
Specifies the type of mirror log for LVs with the "mirror" type
|
|
(does not apply to the "raid1" type.)
|
|
\fBdisk\fP is a persistent log and requires a small amount of
|
|
storage space, usually on a separate device from the data being mirrored.
|
|
\fBcore\fP is not persistent; the log is kept only in memory.
|
|
In this case, the mirror must be synchronized (by copying LV data from
|
|
the first device to others) each time the LV is activated, e.g. after reboot.
|
|
\fBmirrored\fP is a persistent log that is itself mirrored, but
|
|
should be avoided. Instead, use the raid1 type for log redundancy.
|
|
.
|
|
.HP
|
|
\fB-m\fP|\fB--mirrors\fP \fINumber\fP
|
|
.br
|
|
Specifies the number of mirror images in addition to the original LV
|
|
image, e.g. --mirrors 1 means there are two images of the data, the
|
|
original and one mirror image.
|
|
Optional positional PV args on the command line can specify the devices
|
|
the images should be placed on.
|
|
There are two mirroring implementations: "raid1" and "mirror".
|
|
These are the names of the corresponding LV types, or "segment types".
|
|
Use the --type option to specify which to use (raid1 is default,
|
|
and mirror is legacy)
|
|
Use \fBlvm.conf\fP(5) \fBglobal/mirror_segtype_default\fP and
|
|
global/raid10_segtype_default to configure the default types.
|
|
See the --nosync option for avoiding initial image synchronization.
|
|
See \fBlvmraid\fP(7) for more information.
|
|
.
|
|
.HP
|
|
\fB--monitor\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
Start (yes) or stop (no) monitoring an LV with dmeventd.
|
|
dmeventd monitors kernel events for an LV, and performs
|
|
automated maintenance for the LV in response to specific events.
|
|
See \fBdmeventd\fP(8) for more information.
|
|
.
|
|
.HP
|
|
\fB-n\fP|\fB--name\fP \fIString\fP
|
|
.br
|
|
Specifies the name of a new LV.
|
|
When unspecified, a default name of "lvol#" is
|
|
generated, where # is a number generated by LVM.
|
|
.
|
|
.HP
|
|
\fB--nohints\fP
|
|
.br
|
|
Do not use the hints file to locate devices for PVs. A command may read
|
|
more devices to find PVs when hints are not used. The command will still
|
|
perform standard hint file invalidation where appropriate.
|
|
.
|
|
.HP
|
|
\fB--nolocking\fP
|
|
.br
|
|
Disable locking. Use with caution, concurrent commands may produce
|
|
incorrect results.
|
|
.
|
|
.HP
|
|
\fB--nosync\fP
|
|
.br
|
|
Causes the creation of mirror, raid1, raid4, raid5 and raid10 to skip the
|
|
initial synchronization. In case of mirror, raid1 and raid10, any data
|
|
written afterwards will be mirrored, but the original contents will not be
|
|
copied. In case of raid4 and raid5, no parity blocks will be written,
|
|
though any data written afterwards will cause parity blocks to be stored.
|
|
This is useful for skipping a potentially long and resource intensive initial
|
|
sync of an empty mirror/raid1/raid4/raid5 and raid10 LV.
|
|
This option is not valid for raid6, because raid6 relies on proper parity
|
|
(P and Q Syndromes) being created during initial synchronization in order
|
|
to reconstruct proper user date in case of device failures.
|
|
raid0 and raid0_meta do not provide any data copies or parity support
|
|
and thus do not support initial synchronization.
|
|
.
|
|
.HP
|
|
\fB--noudevsync\fP
|
|
.br
|
|
Disables udev synchronization. The process will not wait for notification
|
|
from udev. It will continue irrespective of any possible udev processing
|
|
in the background. Only use this if udev is not running or has rules that
|
|
ignore the devices LVM creates.
|
|
.
|
|
.HP
|
|
\fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP
|
|
.br
|
|
Set access permission to read only \fBr\fP or read and write \fBrw\fP.
|
|
.
|
|
.HP
|
|
\fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
When yes, makes the specified minor number persistent.
|
|
.
|
|
.HP
|
|
\fB--pooldatavdo\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
Use VDO type volume for pool data volume.
|
|
.
|
|
.HP
|
|
\fB--poolmetadatasize\fP \fISize\fP[m|UNIT]
|
|
.br
|
|
Specifies the size of the new pool metadata LV.
|
|
.
|
|
.HP
|
|
\fB--poolmetadataspare\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
Enable or disable the automatic creation and management of a
|
|
spare pool metadata LV in the VG. A spare metadata LV is reserved
|
|
space that can be used when repairing a pool.
|
|
.
|
|
.HP
|
|
\fB--profile\fP \fIString\fP
|
|
.br
|
|
An alias for --commandprofile or --metadataprofile, depending
|
|
on the command.
|
|
.
|
|
.HP
|
|
\fB-q\fP|\fB--quiet\fP ...
|
|
.br
|
|
Suppress output and log messages. Overrides --debug and --verbose.
|
|
Repeat once to also suppress any prompts with answer 'no'.
|
|
.
|
|
.HP
|
|
\fB--raidintegrity\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
Enable or disable data integrity checksums for raid images.
|
|
.
|
|
.HP
|
|
\fB--raidintegrityblocksize\fP \fINumber\fP
|
|
.br
|
|
The block size to use for dm-integrity on raid images.
|
|
The integrity block size should usually match the device
|
|
logical block size, or the file system block size.
|
|
It may be less than the file system block size, but not
|
|
less than the device logical block size.
|
|
Possible values: 512, 1024, 2048, 4096.
|
|
.
|
|
.HP
|
|
\fB--raidintegritymode\fP \fIString\fP
|
|
.br
|
|
Use a journal (default) or bitmap for keeping integrity checksums consistent
|
|
in case of a crash. The bitmap areas are recalculated after a crash, so corruption
|
|
in those areas would not be detected. A journal does not have this problem.
|
|
The journal mode doubles writes to storage, but can improve performance for
|
|
scattered writes packed into a single journal write.
|
|
bitmap mode can in theory achieve full write throughput of the device,
|
|
but would not benefit from the potential scattered write optimization.
|
|
.
|
|
.HP
|
|
\fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP
|
|
.br
|
|
Sets read ahead sector count of an LV.
|
|
\fBauto\fP is the default which allows the kernel to choose
|
|
a suitable value automatically.
|
|
\fBnone\fP is equivalent to zero.
|
|
.
|
|
.HP
|
|
\fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT]
|
|
.br
|
|
Size of each raid or mirror synchronization region.
|
|
\fBlvm.conf\fP(5) \fBactivation/raid_region_size\fP can be used to
|
|
configure a default.
|
|
.
|
|
.HP
|
|
\fB--reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP
|
|
.br
|
|
Overrides current output format for reports which is defined globally by
|
|
the report/output_format setting in \fBlvm.conf\fP(5).
|
|
\fBbasic\fP is the original format with columns and rows.
|
|
If there is more than one report per command, each report is prefixed
|
|
with the report name for identification. \fBjson\fP produces report
|
|
output in JSON format. \fBjson_std\fP produces report output in
|
|
JSON format which is more compliant with JSON standard.
|
|
See \fBlvmreport\fP(7) for more information.
|
|
.
|
|
.HP
|
|
\fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
Persistently sets (yes) or clears (no) the "activation skip" flag on an LV.
|
|
An LV with this flag set is not activated unless the
|
|
--ignoreactivationskip option is used by the activation command.
|
|
This flag is set by default on new thin snapshot LVs.
|
|
The flag is not applied to deactivation.
|
|
The current value of the flag is indicated in the lvs lv_attr bits.
|
|
.
|
|
.HP
|
|
\fB--setautoactivation\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
Set the autoactivation property on a VG or LV.
|
|
Display the property with vgs or lvs "-o autoactivation".
|
|
When the autoactivation property is disabled, the VG or LV
|
|
will not be activated by a command doing autoactivation
|
|
(vgchange, lvchange, or pvscan using -aay.)
|
|
If autoactivation is disabled on a VG, no LVs will be autoactivated
|
|
in that VG, and the LV autoactivation property has no effect.
|
|
If autoactivation is enabled on a VG, autoactivation can be disabled
|
|
for individual LVs.
|
|
.
|
|
.HP
|
|
\fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT]
|
|
.br
|
|
Specifies the size of the new LV.
|
|
The --size and --extents options are alternate methods of specifying size.
|
|
The total number of physical extents used will be
|
|
greater when redundant data is needed for RAID levels.
|
|
.
|
|
.HP
|
|
\fB-s\fP|\fB--snapshot\fP
|
|
.br
|
|
Create a snapshot. Snapshots provide a "frozen image" of an origin LV.
|
|
The snapshot LV can be used, e.g. for backups, while the origin LV
|
|
continues to be used.
|
|
This option can create a COW (copy on write) snapshot,
|
|
or a thin snapshot (in a thin pool.)
|
|
Thin snapshots are created when the origin is a thin LV and
|
|
the size option is NOT specified. Thin snapshots share the same blocks
|
|
in the thin pool, and do not allocate new space from the VG.
|
|
Thin snapshots are created with the "activation skip" flag,
|
|
see --setactivationskip.
|
|
A thin snapshot of a non-thin "external origin" LV is created
|
|
when a thin pool is specified. Unprovisioned blocks in the thin snapshot
|
|
LV are read from the external origin LV. The external origin LV must
|
|
be read-only.
|
|
See \fBlvmthin\fP(7) for more information about LVM thin provisioning.
|
|
COW snapshots are created when a size is specified. The size is allocated
|
|
from space in the VG, and is the amount of space that can be used
|
|
for saving COW blocks as writes occur to the origin or snapshot.
|
|
The size chosen should depend upon the amount of writes that are expected;
|
|
often 20% of the origin LV is enough. If COW space runs low, it can
|
|
be extended with lvextend (shrinking is also allowed with lvreduce.)
|
|
A small amount of the COW snapshot LV size is used to track COW block
|
|
locations, so the full size is not available for COW data blocks.
|
|
Use lvs to check how much space is used, and see --monitor to
|
|
to automatically extend the size to avoid running out of space.
|
|
.
|
|
.HP
|
|
\fB-i\fP|\fB--stripes\fP \fINumber\fP
|
|
.br
|
|
Specifies the number of stripes in a striped LV. This is the number of
|
|
PVs (devices) that a striped LV is spread across. Data that
|
|
appears sequential in the LV is spread across multiple devices in units of
|
|
the stripe size (see --stripesize). This does not change existing
|
|
allocated space, but only applies to space being allocated by the command.
|
|
When creating a RAID 4/5/6 LV, this number does not include the extra
|
|
devices that are required for parity. The largest number depends on
|
|
the RAID type (raid0: 64, raid10: 32, raid4/5: 63, raid6: 62), and
|
|
when unspecified, the default depends on the RAID type
|
|
(raid0: 2, raid10: 2, raid4/5: 3, raid6: 5.)
|
|
To stripe a new raid LV across all PVs by default,
|
|
see \fBlvm.conf\fP(5) \fBallocation/raid_stripe_all_devices\fP.
|
|
.
|
|
.HP
|
|
\fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT]
|
|
.br
|
|
The amount of data that is written to one device before
|
|
moving to the next in a striped LV.
|
|
.
|
|
.HP
|
|
\fB-t\fP|\fB--test\fP
|
|
.br
|
|
Run in test mode. Commands will not update metadata.
|
|
This is implemented by disabling all metadata writing but nevertheless
|
|
returning success to the calling function. This may lead to unusual
|
|
error messages in multi-stage operations if a tool relies on reading
|
|
back metadata it believes has changed but hasn't.
|
|
.
|
|
.HP
|
|
\fB-T\fP|\fB--thin\fP
|
|
.br
|
|
Specifies the command is handling a thin LV or thin pool.
|
|
See --type thin, --type thin-pool, and --virtualsize.
|
|
See \fBlvmthin\fP(7) for more information about LVM thin provisioning.
|
|
.
|
|
.HP
|
|
\fB--thinpool\fP \fILV\fP
|
|
.br
|
|
The name of a thin pool LV.
|
|
.
|
|
.HP
|
|
.ad l
|
|
\fB--type\fP \c
|
|
.nh
|
|
\%\fBlinear\fP|\:\fBstriped\fP|\:\fBsnapshot\fP|\:\fBraid\fP|\:\fBmirror\fP|\:\fBthin\fP|\:\fBthin-pool\fP|\:\fBvdo\fP|\:\fBvdo-pool\fP|\:\fBcache\fP|\:\fBcache-pool\fP|\:\fBwritecache\fP
|
|
.hy
|
|
.ad b
|
|
.br
|
|
The LV type, also known as "segment type" or "segtype".
|
|
See usage descriptions for the specific ways to use these types.
|
|
For more information about redundancy and performance (\fBraid\fP<N>, \fBmirror\fP, \fBstriped\fP, \fBlinear\fP) see \fBlvmraid\fP(7).
|
|
For thin provisioning (\fBthin\fP, \fBthin-pool\fP) see \fBlvmthin\fP(7).
|
|
For performance caching (\fBcache\fP, \fBcache-pool\fP) see \fBlvmcache\fP(7).
|
|
For copy-on-write snapshots (\fBsnapshot\fP) see usage definitions.
|
|
For VDO (\fBvdo\fP) see \fBlvmvdo\fP(7).
|
|
Several commands omit an explicit type option because the type
|
|
is inferred from other options or shortcuts
|
|
(e.g. --stripes, --mirrors, --snapshot, --virtualsize, --thin, --cache, --vdo).
|
|
Use inferred types with care because it can lead to unexpected results.
|
|
.
|
|
.HP
|
|
\fB--vdo\fP
|
|
.br
|
|
Specifies the command is handling VDO LV.
|
|
See --type vdo.
|
|
See \fBlvmvdo\fP(7) for more information about VDO usage.
|
|
.
|
|
.HP
|
|
\fB--vdopool\fP \fILV\fP
|
|
.br
|
|
The name of a VDO pool LV.
|
|
See \fBlvmvdo\fP(7) for more information about VDO usage.
|
|
.
|
|
.HP
|
|
\fB--vdosettings\fP \fIString\fP
|
|
.br
|
|
Specifies tunable VDO options for VDO LVs.
|
|
Use the form 'option=value' or 'option1=value option2=value', or
|
|
repeat --vdosettings for each option being set.
|
|
These settings override the default VDO behaviors.
|
|
To remove vdosettings and revert to the default
|
|
VDO behaviors, use --vdosettings 'default'.
|
|
See \fBlvmvdo\fP(7) for more information.
|
|
.
|
|
.HP
|
|
\fB-v\fP|\fB--verbose\fP ...
|
|
.br
|
|
Set verbose level. Repeat from 1 to 4 times to increase the detail
|
|
of messages sent to stdout and stderr.
|
|
.
|
|
.HP
|
|
\fB--version\fP
|
|
.br
|
|
Display version information.
|
|
.
|
|
.HP
|
|
\fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT]
|
|
.br
|
|
The virtual size of a new thin LV.
|
|
See \fBlvmthin\fP(7) for more information about LVM thin provisioning.
|
|
Using virtual size (-V) and actual size (-L) together creates
|
|
a sparse LV.
|
|
\fBlvm.conf\fP(5) \fBglobal/sparse_segtype_default\fP determines the
|
|
default segment type used to create a sparse LV.
|
|
Anything written to a sparse LV will be returned when reading from it.
|
|
Reading from other areas of the LV will return blocks of zeros.
|
|
When using a snapshot to create a sparse LV, a hidden virtual device
|
|
is created using the zero target, and the LV has the suffix _vorigin.
|
|
Snapshots are less efficient than thin provisioning when creating
|
|
large sparse LVs (GiB).
|
|
.
|
|
.HP
|
|
\fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
Controls detection and subsequent wiping of signatures on new LVs.
|
|
There is a prompt for each signature detected to confirm its wiping
|
|
(unless --yes is used to override confirmations.)
|
|
When not specified, signatures are wiped whenever zeroing is done
|
|
(see --zero). This behaviour can be configured with
|
|
\fBlvm.conf\fP(5) \fBallocation/wipe_signatures_when_zeroing_new_lvs\fP.
|
|
If blkid wiping is used (\fBlvm.conf\fP(5) \fBallocation/use_blkid_wiping\fP)
|
|
and LVM is compiled with blkid wiping support, then the blkid(8)
|
|
library is used to detect the signatures (use blkid -k to list the
|
|
signatures that are recognized).
|
|
Otherwise, native LVM code is used to detect signatures
|
|
(only MD RAID, swap and LUKS signatures are detected in this case.)
|
|
The LV is not wiped if the read only flag is set.
|
|
.
|
|
.HP
|
|
\fB-y\fP|\fB--yes\fP
|
|
.br
|
|
Do not prompt for confirmation interactively but always assume the
|
|
answer yes. Use with extreme caution.
|
|
(For automatic no, see -qq.)
|
|
.
|
|
.HP
|
|
\fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
Controls zeroing of the first 4 KiB of data in the new LV.
|
|
Default is \fBy\fP.
|
|
Snapshot COW volumes are always zeroed.
|
|
For thin pools, this controls zeroing of provisioned blocks.
|
|
LV is not zeroed if the read only flag is set.
|
|
Warning: trying to mount an unzeroed LV can cause the system to hang.
|
|
.
|
|
.SH VARIABLES
|
|
.
|
|
.TP
|
|
.I VG
|
|
Volume Group name. See \fBlvm\fP(8) for valid names.
|
|
For lvcreate, the required VG positional arg may be
|
|
omitted when the VG name is included in another option,
|
|
e.g. --name VG/LV.
|
|
.TP
|
|
.I LV
|
|
Logical Volume name. See \fBlvm\fP(8) for valid names.
|
|
An LV positional arg generally includes the VG name and LV name, e.g. VG/LV.
|
|
LV1 indicates the LV must have a specific type, where the
|
|
accepted LV types are listed. (raid represents raid<N> type).
|
|
.TP
|
|
.I PV
|
|
Physical Volume name, a device path under /dev.
|
|
For commands managing physical extents, a PV positional arg
|
|
generally accepts a suffix indicating a range (or multiple ranges)
|
|
of physical extents (PEs). When the first PE is omitted, it defaults
|
|
to the start of the device, and when the last PE is omitted it defaults to end.
|
|
Start and end range (inclusive): \fIPV\fP[\fB:\fP\fIPE\fP\fB-\fP\fIPE\fP]...
|
|
Start and length range (counting from 0): \fIPV\fP[\fB:\fP\fIPE\fP\fB+\fP\fIPE\fP]...
|
|
.TP
|
|
.I String
|
|
See the option description for information about the string content.
|
|
.TP
|
|
.IR Size [UNIT]
|
|
Size is an input number that accepts an optional unit.
|
|
Input units are always treated as base two values, regardless of
|
|
capitalization, e.g. 'k' and 'K' both refer to 1024.
|
|
The default input unit is specified by letter, followed by |UNIT.
|
|
UNIT represents other possible input units:
|
|
.BR b | B
|
|
is bytes,
|
|
.BR s | S
|
|
is sectors of 512 bytes,
|
|
.BR k | K
|
|
is KiB,
|
|
.BR m | M
|
|
is MiB,
|
|
.BR g | G
|
|
is GiB,
|
|
.BR t | T
|
|
is TiB,
|
|
.BR p | P
|
|
is PiB,
|
|
.BR e | E
|
|
is EiB.
|
|
(This should not be confused with the output control --units, where
|
|
capital letters mean multiple of 1000.)
|
|
.
|
|
.SH ENVIRONMENT VARIABLES
|
|
.
|
|
See \fBlvm\fP(8) for information about environment variables used by lvm.
|
|
For example, LVM_VG_NAME can generally be substituted for a required VG parameter.
|
|
.
|
|
.SH ADVANCED USAGE
|
|
.
|
|
Alternate command forms, advanced command usage, and listing of all valid syntax for completeness.
|
|
.P
|
|
Create an LV that returns errors when used.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBerror\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create an LV that returns zeros when read.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBzero\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a linear LV.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBlinear\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a striped LV (also see lvcreate --stripes).
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBstriped\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a mirror LV (also see --type raid1).
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBmirror\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-m\fP|\fB--mirrors\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--mirrorlog\fP \fBcore\fP|\fBdisk\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a COW snapshot LV of an origin LV
|
|
.br
|
|
(also see --snapshot).
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBsnapshot\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fILV\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-s\fP|\fB--snapshot\fP ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a sparse COW snapshot LV of a virtual origin LV
|
|
.br
|
|
(also see --snapshot).
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBsnapshot\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT]
|
|
.RS 5
|
|
\fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] \fIVG\fP
|
|
.RE
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-s\fP|\fB--snapshot\fP ]
|
|
.br
|
|
[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a thin pool.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB-T\fP|\fB--thin\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB--type thin-pool\fP ] (implied)
|
|
.br
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ]
|
|
.br
|
|
[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--pooldatavdo\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--compression\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--deduplication\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--vdosettings\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a thin pool named in --thinpool.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fB--thinpool\fP \fILV\fP\fI_new\fP \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB--type thin-pool\fP ] (implied)
|
|
.br
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-T\fP|\fB--thin\fP ]
|
|
.br
|
|
[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ]
|
|
.br
|
|
[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--pooldatavdo\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--compression\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--deduplication\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--vdosettings\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a cache pool named by the --cachepool arg
|
|
.br
|
|
(variant, uses --cachepool in place of --name).
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBcache-pool\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT]
|
|
.RS 5
|
|
\fB--cachepool\fP \fILV\fP\fI_new\fP \fIVG\fP
|
|
.RE
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-H\fP|\fB--cache\fP ]
|
|
.br
|
|
[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ]
|
|
.br
|
|
[ \fB--cachepolicy\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--cachesettings\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ]
|
|
.br
|
|
[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a thin LV in a thin pool.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBthin\fP \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT]
|
|
.RS 5
|
|
\fB--thinpool\fP \fILV\fP \fIVG\fP
|
|
.RE
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-T\fP|\fB--thin\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a thin LV in a thin pool named in the first arg
|
|
.br
|
|
(variant, also see --thinpool for naming pool).
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBthin\fP \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] \fILV1\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-T\fP|\fB--thin\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.P
|
|
.RS 4
|
|
LV1 types: thinpool
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a thin LV in the thin pool named in the first arg
|
|
.br
|
|
(also see --thinpool for naming pool.)
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] \fILV1\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB--type thin\fP ] (implied)
|
|
.br
|
|
.br
|
|
[ \fB-T\fP|\fB--thin\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.P
|
|
.RS 4
|
|
LV1 types: thinpool
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a thin LV that is a snapshot of an existing thin LV.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBthin\fP \fILV1\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-T\fP|\fB--thin\fP ]
|
|
.br
|
|
[ \fB-s\fP|\fB--snapshot\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.P
|
|
.RS 4
|
|
LV1 types: thin
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a thin LV that is a snapshot of an existing thin LV.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB-T\fP|\fB--thin\fP \fILV1\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB--type thin\fP ] (implied)
|
|
.br
|
|
.br
|
|
[ \fB-s\fP|\fB--snapshot\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.P
|
|
.RS 4
|
|
LV1 types: thin
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a thin LV that is a snapshot of an external origin LV.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB-s\fP|\fB--snapshot\fP \fB--thinpool\fP \fILV\fP \fILV\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB--type thin\fP ] (implied)
|
|
.br
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a VDO LV with VDO pool.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--vdo\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB--type vdo\fP ] (implied)
|
|
.br
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--vdopool\fP \fILV\fP\fI_new\fP ]
|
|
.br
|
|
[ \fB--compression\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--deduplication\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--vdosettings\fP \fIString\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a VDO LV with VDO pool.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--vdopool\fP \fILV\fP\fI_new\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB--type vdo\fP ] (implied)
|
|
.br
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--compression\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--deduplication\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--vdosettings\fP \fIString\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a thin LV, first creating a thin pool for it,
|
|
.br
|
|
where the new thin pool is named by the --thinpool arg.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBthin\fP \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT]
|
|
.RS 5
|
|
\fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fB--thinpool\fP \fILV\fP\fI_new\fP \fIVG\fP
|
|
.RE
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-T\fP|\fB--thin\fP ]
|
|
.br
|
|
[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ]
|
|
.br
|
|
[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--pooldatavdo\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--compression\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--deduplication\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--vdosettings\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a thin LV, first creating a thin pool for it,
|
|
.br
|
|
where the new thin pool is named by --thinpool.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT]
|
|
.RS 5
|
|
\fB--thinpool\fP \fILV\fP\fI_new\fP \fIVG\fP
|
|
.RE
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB--type thin\fP ] (implied)
|
|
.br
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-T\fP|\fB--thin\fP ]
|
|
.br
|
|
[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ]
|
|
.br
|
|
[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--pooldatavdo\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--compression\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--deduplication\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--vdosettings\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a thin LV, first creating a thin pool for it,
|
|
.br
|
|
where the new thin pool is named in the first arg,
|
|
.br
|
|
or the new thin pool name is generated when the first
|
|
.br
|
|
arg is a VG name.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBthin\fP \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT]
|
|
.RS 5
|
|
\fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP|\fILV\fP\fI_new\fP
|
|
.RE
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-T\fP|\fB--thin\fP ]
|
|
.br
|
|
[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ]
|
|
.br
|
|
[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--pooldatavdo\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--compression\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--deduplication\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--vdosettings\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a thin LV, first creating a thin pool for it,
|
|
.br
|
|
where the new thin pool is named in the first arg,
|
|
.br
|
|
or the new thin pool name is generated when the first
|
|
.br
|
|
arg is a VG name.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB-T\fP|\fB--thin\fP \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT]
|
|
.RS 5
|
|
\fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP|\fILV\fP\fI_new\fP
|
|
.RE
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB--type thin\fP ] (implied)
|
|
.br
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ]
|
|
.br
|
|
[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--pooldatavdo\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--compression\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--deduplication\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--vdosettings\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a thin LV, first creating a thin pool for it.
|
|
.br
|
|
Create a sparse snapshot of a virtual origin LV
|
|
.br
|
|
Chooses type thin or snapshot according to
|
|
.br
|
|
config setting sparse_segtype_default.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB--type thin\fP|\fBsnapshot\fP ] (implied)
|
|
.br
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-s\fP|\fB--snapshot\fP ]
|
|
.br
|
|
[ \fB-T\fP|\fB--thin\fP ]
|
|
.br
|
|
[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ]
|
|
.br
|
|
[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--pooldatavdo\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--compression\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--deduplication\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--vdosettings\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a new LV, then attach the specified cachepool
|
|
.br
|
|
which converts the new LV to type cache.
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fB--cachepool\fP \fILV\fP \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB--type cache\fP ] (implied)
|
|
.br
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-H\fP|\fB--cache\fP ]
|
|
.br
|
|
[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ]
|
|
.br
|
|
[ \fB--cachepolicy\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--cachesettings\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
Create a new LV, then attach the specified cachepool
|
|
.br
|
|
which converts the new LV to type cache.
|
|
.br
|
|
(variant, also use --cachepool).
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB--type\fP \fBcache\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fILV1\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-H\fP|\fB--cache\fP ]
|
|
.br
|
|
[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ]
|
|
.br
|
|
[ \fB--cachepolicy\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--cachesettings\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ]
|
|
.br
|
|
[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
.RS 4
|
|
LV1 types: cachepool
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|
|
When the LV arg is a cachepool, then create a new LV and
|
|
.br
|
|
attach the cachepool arg to it.
|
|
.br
|
|
(variant, use --type cache and --cachepool.)
|
|
.br
|
|
When the LV arg is not a cachepool, then create a new cachepool
|
|
.br
|
|
and attach it to the LV arg (alternative, use lvconvert.)
|
|
.br
|
|
.P
|
|
\fBlvcreate\fP \fB-H\fP|\fB--cache\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fILV\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ \fB--type cache\fP ] (implied)
|
|
.br
|
|
[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ]
|
|
.br
|
|
[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
|
|
.br
|
|
[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ]
|
|
.br
|
|
[ \fB--cachepolicy\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--cachesettings\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ]
|
|
.br
|
|
[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ]
|
|
.br
|
|
[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.RS 4
|
|
[ \fIPV\fP ... ]
|
|
.RE
|
|
.P
|
|
\(em
|
|
.P
|