Alternate command forms, advanced command usage, and listing of
all valid syntax for completeness.
Change the region size of an LV.
lvconvert -R|--regionsize Size[m|UNIT] LV1
[ COMMON_OPTIONS ]
LV1 types: raid
—
Change the type of mirror log used by a mirror LV.
lvconvert --mirrorlog core|disk LV1
[ COMMON_OPTIONS ]
[ PV ... ]
LV1 types: mirror
—
Convert LV to a thin LV, using the original LV as an external
origin.
lvconvert -T|--thin --thinpool LV LV1
[ --type thin ] (implied)
[ -r|--readahead auto|none|Number ]
[ -c|--chunksize Size[k|UNIT] ]
[ -Z|--zero y|n ]
[ --originname LV_new ]
[ --poolmetadata LV ]
[ --poolmetadatasize Size[m|UNIT] ]
[ --poolmetadataspare y|n ]
[ --metadataprofile String ]
[ COMMON_OPTIONS ]
LV1 types: linear striped thin cache raid error zero
—
Attach a cache pool to an LV.
lvconvert -H|--cache --cachepool LV LV1
[ --type cache ] (implied)
[ -Z|--zero y|n ]
[ -r|--readahead auto|none|Number ]
[ -c|--chunksize Size[k|UNIT] ]
[ --cachemetadataformat auto|1|2 ]
[ --cachemode writethrough|writeback|passthrough ]
[ --cachepolicy String ]
[ --cachesettings String ]
[ --poolmetadata LV ]
[ --poolmetadatasize Size[m|UNIT] ]
[ --poolmetadataspare y|n ]
[ --metadataprofile String ]
[ COMMON_OPTIONS ]
LV1 types: linear striped thinpool vdo vdopool vdopooldata
raid
—
Attach a cache to an LV, converts the LV to type cache.
lvconvert -H|--cache --cachevol LV LV1
[ -Z|--zero y|n ]
[ -c|--chunksize Size[k|UNIT] ]
[ --cachemetadataformat auto|1|2 ]
[ --cachemode writethrough|writeback|passthrough ]
[ --cachepolicy String ]
[ --cachesettings String ]
[ --poolmetadatasize Size[m|UNIT] ]
[ COMMON_OPTIONS ]
LV1 types: linear striped thinpool raid
—
Convert LV to type vdopool.
lvconvert --vdopool LV
[ --type vdo-pool ] (implied)
[ -r|--readahead auto|none|Number ]
[ -Z|--zero y|n ]
[ -n|--name LV_new ]
[ -V|--virtualsize Size[m|UNIT] ]
[ --metadataprofile String ]
[ --compression y|n ]
[ --deduplication y|n ]
[ COMMON_OPTIONS ]
—
Detach and delete a cache from an LV.
lvconvert --uncache LV1
[ --cachesettings String ]
[ COMMON_OPTIONS ]
LV1 types: thinpool cache vdopool writecache
—
Swap metadata LV in a thin pool or cache pool (for repair only).
lvconvert --swapmetadata --poolmetadata LV LV1
[ -c|--chunksize Size[k|UNIT] ]
[ COMMON_OPTIONS ]
LV1 types: thinpool cachepool
—
Merge LV that was split from a mirror (variant, use
--mergemirrors).
Merge thin LV into its origin LV (variant, use --mergethin).
Merge COW snapshot LV into its origin (variant, use
--mergesnapshot).
lvconvert --merge VG|LV1|Tag ...
[ -i|--interval Number ]
[ COMMON_OPTIONS ]
LV1 types: linear striped snapshot thin raid
—
Separate a COW snapshot from its origin LV.
lvconvert --splitsnapshot LV1
[ COMMON_OPTIONS ]
LV1 types: snapshot
—
Combine a former COW snapshot (second arg) with a former
origin LV (first arg) to reverse a splitsnapshot command.
lvconvert -s|--snapshot LV LV1
[ --type snapshot ] (implied)
[ -c|--chunksize Size[k|UNIT] ]
[ -Z|--zero y|n ]
[ COMMON_OPTIONS ]
LV1 types: linear striped
—
Poll LV to continue conversion (also see --startpoll)
or waits till conversion/mirror syncing is finished
lvconvert LV1
[ COMMON_OPTIONS ]
LV1 types: mirror raid
—
