Alternate command forms, advanced command usage, and listing of
all valid syntax for completeness.
Create an LV that returns errors when used.
lvcreate --type error -L|--size Size[m|UNIT] VG
[ -l|--extents Number[PERCENT] ]
[ COMMON_OPTIONS ]
—
Create an LV that returns zeros when read.
lvcreate --type zero -L|--size Size[m|UNIT] VG
[ -l|--extents Number[PERCENT] ]
[ COMMON_OPTIONS ]
—
Create a linear LV.
lvcreate --type linear -L|--size Size[m|UNIT] VG
[ -l|--extents Number[PERCENT] ]
[ COMMON_OPTIONS ]
[ PV ... ]
—
Create a striped LV (also see lvcreate --stripes).
lvcreate --type striped -L|--size Size[m|UNIT] VG
[ -l|--extents Number[PERCENT] ]
[ -i|--stripes Number ]
[ -I|--stripesize Size[k|UNIT] ]
[ COMMON_OPTIONS ]
[ PV ... ]
—
Create a mirror LV (also see --type raid1).
lvcreate --type mirror -L|--size Size[m|UNIT] VG
[ -l|--extents Number[PERCENT] ]
[ -i|--stripes Number ]
[ -I|--stripesize Size[k|UNIT] ]
[ -m|--mirrors Number ]
[ -R|--regionsize Size[m|UNIT] ]
[ --mirrorlog core|disk ]
[ COMMON_OPTIONS ]
[ PV ... ]
—
Create a COW snapshot LV of an origin LV
(also see --snapshot).
lvcreate --type snapshot -L|--size Size[m|UNIT] LV
[ -l|--extents Number[PERCENT] ]
[ -s|--snapshot ]
[ -i|--stripes Number ]
[ -I|--stripesize Size[k|UNIT] ]
[ -c|--chunksize Size[k|UNIT] ]
[ COMMON_OPTIONS ]
[ PV ... ]
—
Create a sparse COW snapshot LV of a virtual origin LV
(also see --snapshot).
lvcreate --type snapshot -L|--size Size[m|UNIT]
-V|--virtualsize Size[m|UNIT] VG
[ -l|--extents Number[PERCENT] ]
[ -s|--snapshot ]
[ -c|--chunksize Size[k|UNIT] ]
[ COMMON_OPTIONS ]
[ PV ... ]
—
Create a thin pool.
lvcreate -T|--thin -L|--size Size[m|UNIT] VG
[ --type thin-pool ] (implied)
[ -l|--extents Number[PERCENT] ]
[ -i|--stripes Number ]
[ -I|--stripesize Size[k|UNIT] ]
[ -c|--chunksize Size[k|UNIT] ]
[ --discards passdown|nopassdown|ignore ]
[ --errorwhenfull y|n ]
[ --poolmetadatasize Size[m|UNIT] ]
[ --poolmetadataspare y|n ]
[ COMMON_OPTIONS ]
[ PV ... ]
—
Create a thin pool named in --thinpool.
lvcreate -L|--size Size[m|UNIT] --thinpool LV_new VG
[ --type thin-pool ] (implied)
[ -l|--extents Number[PERCENT] ]
[ -i|--stripes Number ]
[ -I|--stripesize Size[k|UNIT] ]
[ -T|--thin ]
[ -c|--chunksize Size[k|UNIT] ]
[ --discards passdown|nopassdown|ignore ]
[ --errorwhenfull y|n ]
[ --poolmetadatasize Size[m|UNIT] ]
[ --poolmetadataspare y|n ]
[ COMMON_OPTIONS ]
[ PV ... ]
—
Create a cache pool named by the --cachepool arg
(variant, uses --cachepool in place of --name).
lvcreate --type cache-pool -L|--size Size[m|UNIT]
--cachepool LV_new VG
[ -l|--extents Number[PERCENT] ]
[ -i|--stripes Number ]
[ -I|--stripesize Size[k|UNIT] ]
[ -H|--cache ]
[ -c|--chunksize Size[k|UNIT] ]
[ --cachemode writethrough|writeback|passthrough ]
[ --cachepolicy String ]
[ --cachesettings String ]
[ --cachemetadataformat auto|1|2 ]
[ --poolmetadatasize Size[m|UNIT] ]
[ --poolmetadataspare y|n ]
[ COMMON_OPTIONS ]
[ PV ... ]
—
Create a thin LV in a thin pool.
lvcreate --type thin -V|--virtualsize Size[m|UNIT]
--thinpool LV VG
[ -T|--thin ]
[ COMMON_OPTIONS ]
—
Create a thin LV in a thin pool named in the first arg
(variant, also see --thinpool for naming pool).
lvcreate --type thin -V|--virtualsize Size[m|UNIT] LV1
[ -T|--thin ]
[ COMMON_OPTIONS ]
LV1 types: thinpool
—
Create a thin LV in the thin pool named in the first arg
(also see --thinpool for naming pool.)
lvcreate -V|--virtualsize Size[m|UNIT] LV1
[ --type thin ] (implied)
[ -T|--thin ]
[ COMMON_OPTIONS ]
LV1 types: thinpool
—
Create a thin LV that is a snapshot of an existing thin LV.
lvcreate --type thin LV1
[ -T|--thin ]
[ COMMON_OPTIONS ]
LV1 types: thin
—
Create a thin LV that is a snapshot of an existing thin LV.
lvcreate -T|--thin LV1
[ --type thin ] (implied)
[ COMMON_OPTIONS ]
LV1 types: thin
—
Create a thin LV that is a snapshot of an external origin LV.
lvcreate -s|--snapshot --thinpool LV LV
[ --type thin ] (implied)
[ COMMON_OPTIONS ]
—
Create a VDO LV with VDO pool.
lvcreate --vdo -L|--size Size[m|UNIT] VG
[ --type vdo ] (implied)
[ -l|--extents Number[PERCENT] ]
[ -i|--stripes Number ]
[ -I|--stripesize Size[k|UNIT] ]
[ -V|--virtualsize Size[m|UNIT] ]
[ --vdopool LV_new ]
[ --compression y|n ]
[ --deduplication y|n ]
[ COMMON_OPTIONS ]
[ PV ... ]
—
Create a VDO LV with VDO pool.
lvcreate --vdopool LV_new -L|--size Size[m|UNIT] VG
[ --type vdo ] (implied)
[ -l|--extents Number[PERCENT] ]
[ -i|--stripes Number ]
[ -I|--stripesize Size[k|UNIT] ]
[ -V|--virtualsize Size[m|UNIT] ]
[ --compression y|n ]
[ --deduplication y|n ]
[ COMMON_OPTIONS ]
[ PV ... ]
—
Create a thin LV, first creating a thin pool for it,
where the new thin pool is named by the --thinpool arg.
lvcreate --type thin -V|--virtualsize Size[m|UNIT]
-L|--size Size[m|UNIT] --thinpool LV_new VG
[ -l|--extents Number[PERCENT] ]
[ -i|--stripes Number ]
[ -I|--stripesize Size[k|UNIT] ]
[ -T|--thin ]
[ -c|--chunksize Size[k|UNIT] ]
[ --discards passdown|nopassdown|ignore ]
[ --errorwhenfull y|n ]
[ --poolmetadatasize Size[m|UNIT] ]
[ --poolmetadataspare y|n ]
[ COMMON_OPTIONS ]
[ PV ... ]
—
Create a thin LV, first creating a thin pool for it,
where the new thin pool is named by --thinpool.
lvcreate -V|--virtualsize Size[m|UNIT] -L|--size Size[m|UNIT]
--thinpool LV_new VG
[ --type thin ] (implied)
[ -l|--extents Number[PERCENT] ]
[ -i|--stripes Number ]
[ -I|--stripesize Size[k|UNIT] ]
[ -T|--thin ]
[ -c|--chunksize Size[k|UNIT] ]
[ --discards passdown|nopassdown|ignore ]
[ --errorwhenfull y|n ]
[ --poolmetadatasize Size[m|UNIT] ]
[ --poolmetadataspare y|n ]
[ COMMON_OPTIONS ]
[ PV ... ]
—
Create a thin LV, first creating a thin pool for it,
where the new thin pool is named in the first arg,
or the new thin pool name is generated when the first
arg is a VG name.
lvcreate --type thin -V|--virtualsize Size[m|UNIT]
-L|--size Size[m|UNIT] VG|LV_new
[ -l|--extents Number[PERCENT] ]
[ -i|--stripes Number ]
[ -I|--stripesize Size[k|UNIT] ]
[ -T|--thin ]
[ -c|--chunksize Size[k|UNIT] ]
[ --discards passdown|nopassdown|ignore ]
[ --errorwhenfull y|n ]
[ --poolmetadatasize Size[m|UNIT] ]
[ --poolmetadataspare y|n ]
[ COMMON_OPTIONS ]
[ PV ... ]
—
Create a thin LV, first creating a thin pool for it,
where the new thin pool is named in the first arg,
or the new thin pool name is generated when the first
arg is a VG name.
lvcreate -T|--thin -V|--virtualsize Size[m|UNIT]
-L|--size Size[m|UNIT] VG|LV_new
[ --type thin ] (implied)
[ -l|--extents Number[PERCENT] ]
[ -i|--stripes Number ]
[ -I|--stripesize Size[k|UNIT] ]
[ -c|--chunksize Size[k|UNIT] ]
[ --discards passdown|nopassdown|ignore ]
[ --errorwhenfull y|n ]
[ --poolmetadatasize Size[m|UNIT] ]
[ --poolmetadataspare y|n ]
[ COMMON_OPTIONS ]
[ PV ... ]
—
Create a thin LV, first creating a thin pool for it.
Create a sparse snapshot of a virtual origin LV
Chooses type thin or snapshot according to
config setting sparse_segtype_default.
lvcreate -L|--size Size[m|UNIT] -V|--virtualsize Size[m|UNIT] VG
[ --type thin|snapshot ] (implied)
[ -l|--extents Number[PERCENT] ]
[ -i|--stripes Number ]
[ -I|--stripesize Size[k|UNIT] ]
[ -s|--snapshot ]
[ -T|--thin ]
[ -c|--chunksize Size[k|UNIT] ]
[ --discards passdown|nopassdown|ignore ]
[ --errorwhenfull y|n ]
[ --poolmetadatasize Size[m|UNIT] ]
[ --poolmetadataspare y|n ]
[ COMMON_OPTIONS ]
[ PV ... ]
—
Create a new LV, then attach the specified cachepool
which converts the new LV to type cache.
lvcreate -L|--size Size[m|UNIT] --cachepool LV VG
[ --type cache ] (implied)
[ -l|--extents Number[PERCENT] ]
[ -i|--stripes Number ]
[ -I|--stripesize Size[k|UNIT] ]
[ -H|--cache ]
[ -c|--chunksize Size[k|UNIT] ]
[ --cachemode writethrough|writeback|passthrough ]
[ --cachepolicy String ]
[ --cachesettings String ]
[ --cachemetadataformat auto|1|2 ]
[ COMMON_OPTIONS ]
[ PV ... ]
—
Create a new LV, then attach the specified cachepool
which converts the new LV to type cache.
(variant, also use --cachepool).
lvcreate --type cache -L|--size Size[m|UNIT] LV1
[ -l|--extents Number[PERCENT] ]
[ -i|--stripes Number ]
[ -I|--stripesize Size[k|UNIT] ]
[ -H|--cache ]
[ -c|--chunksize Size[k|UNIT] ]
[ --cachemode writethrough|writeback|passthrough ]
[ --cachepolicy String ]
[ --cachesettings String ]
[ --cachemetadataformat auto|1|2 ]
[ --poolmetadatasize Size[m|UNIT] ]
[ --poolmetadataspare y|n ]
[ COMMON_OPTIONS ]
[ PV ... ]
LV1 types: cachepool
—
When the LV arg is a cachepool, then create a new LV and
attach the cachepool arg to it.
(variant, use --type cache and --cachepool.)
When the LV arg is not a cachepool, then create a new cachepool
and attach it to the LV arg (alternative, use lvconvert.)
lvcreate -H|--cache -L|--size Size[m|UNIT] LV
[ --type cache ] (implied)
[ -l|--extents Number[PERCENT] ]
[ -c|--chunksize Size[k|UNIT] ]
[ -i|--stripes Number ]
[ -I|--stripesize Size[k|UNIT] ]
[ --cachemode writethrough|writeback|passthrough ]
[ --cachepolicy String ]
[ --cachesettings String ]
[ --cachemetadataformat auto|1|2 ]
[ --poolmetadatasize Size[m|UNIT] ]
[ --poolmetadataspare y|n ]
[ COMMON_OPTIONS ]
[ PV ... ]
—
