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
—