From 6e12a332923bb81cc293b64821226e8c2632742c Mon Sep 17 00:00:00 2001 From: Marian Csontos Date: Wed, 10 Oct 2018 08:31:55 +0200 Subject: [PATCH] build: make generate --- man/lvchange.8_pregen | 53 +- man/lvconvert.8_pregen | 133 +- man/lvcreate.8_pregen | 5620 ++++++++++++++++++++++++++++++++-------- man/lvscan.8_pregen | 35 +- man/pvmove.8_pregen | 7 +- man/pvscan.8_pregen | 11 +- man/vgchange.8_pregen | 23 +- man/vgscan.8_pregen | 10 - 8 files changed, 4726 insertions(+), 1166 deletions(-) diff --git a/man/lvchange.8_pregen b/man/lvchange.8_pregen index 03e0b1cc6..05da60f72 100644 --- a/man/lvchange.8_pregen +++ b/man/lvchange.8_pregen @@ -44,6 +44,10 @@ lvchange - Change the attributes of logical volume(s) \fB--commandprofile\fP \fIString\fP .ad b .br +.ad l + \fB--compression\fP \fBy\fP|\fBn\fP +.ad b +.br .ad l \fB--config\fP \fIString\fP .ad b @@ -56,6 +60,10 @@ lvchange - Change the attributes of logical volume(s) \fB-d\fP|\fB--debug\fP .ad b .br +.ad l + \fB--deduplication\fP \fBy\fP|\fBn\fP +.ad b +.br .ad l \fB--deltag\fP \fITag\fP .ad b @@ -164,6 +172,10 @@ lvchange - Change the attributes of logical volume(s) \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP .ad b .br +.ad l + \fB--readonly\fP +.ad b +.br .ad l \fB--rebuild\fP \fIPV\fP .ad b @@ -271,6 +283,14 @@ required, after which the others are optional. \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP, .ad b .br +.ad l + \fB--compression\fP \fBy\fP|\fBn\fP, +.ad b +.br +.ad l + \fB--deduplication\fP \fBy\fP|\fBn\fP, +.ad b +.br .ad l \fB--detachprofile\fP, .ad b @@ -411,6 +431,10 @@ Activate or deactivate an LV. [ \fB--sysinit\fP ] .ad b .br +.ad l +[ \fB--readonly\fP ] +.ad b +.br [ COMMON_OPTIONS ] .RE .br @@ -703,6 +727,13 @@ See \fBlvm.conf\fP(5) for more information about profiles. .ad b .HP .ad l +\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. +.ad b +.HP +.ad l \fB--config\fP \fIString\fP .br Config settings for the command. These override lvm.conf settings. @@ -729,6 +760,13 @@ messages sent to the log file and/or syslog (if configured). .ad b .HP .ad l +\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. +.ad b +.HP +.ad l \fB--deltag\fP \fITag\fP .br Deletes a tag from a PV, VG or LV. This option can be repeated to delete @@ -940,6 +978,20 @@ a suitable value automatically. .ad b .HP .ad l +\fB--readonly\fP +.br +Run the command in a special read-only mode which will read on-disk +metadata without needing to take any locks. This can be used to peek +inside metadata used by a virtual machine image while the virtual +machine is running. +It can also be used to peek inside the metadata of clustered VGs +when clustered locking is not configured or running. No attempt +will be made to communicate with the device-mapper kernel driver, so +this option is unable to report whether or not LVs are +actually in use. +.ad b +.HP +.ad l \fB--rebuild\fP \fIPV\fP .br Selects a PV to rebuild in a raid LV. Multiple PVs can be rebuilt by @@ -1027,7 +1079,6 @@ available. As such, some functionality needs to be disabled and this option acts as a shortcut which selects an appropriate set of options. Currently, this is equivalent to using --ignorelockingfailure, --ignoremonitoring, --poll n, and setting env var LVM_SUPPRESS_LOCKING_FAILURE_MESSAGES. -When used in conjunction with lvmetad enabled and running, vgchange/lvchange skip autoactivation, and defer to pvscan autoactivation. .ad b .HP diff --git a/man/lvconvert.8_pregen b/man/lvconvert.8_pregen index c9df4da14..635967f21 100644 --- a/man/lvconvert.8_pregen +++ b/man/lvconvert.8_pregen @@ -50,6 +50,10 @@ lvconvert - Change logical volume layout \fB--commandprofile\fP \fIString\fP .ad b .br +.ad l + \fB--compression\fP \fBy\fP|\fBn\fP +.ad b +.br .ad l \fB--config\fP \fIString\fP .ad b @@ -58,6 +62,10 @@ lvconvert - Change logical volume layout \fB-d\fP|\fB--debug\fP .ad b .br +.ad l + \fB--deduplication\fP \fBy\fP|\fBn\fP +.ad b +.br .ad l \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP .ad b @@ -226,6 +234,10 @@ lvconvert - Change logical volume layout \fB--usepolicies\fP .ad b .br +.ad l + \fB--vdopool\fP \fILV\fP +.ad b +.br .ad l \fB-v\fP|\fB--verbose\fP .ad b @@ -234,6 +246,10 @@ lvconvert - Change logical volume layout \fB--version\fP .ad b .br +.ad l + \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] +.ad b +.br .ad l \fB-y\fP|\fB--yes\fP .ad b @@ -479,7 +495,7 @@ Split images from a raid1 or mirror LV and use them to create a new LV. .RE - -Split images from a raid1 LV and track changes to origin. +Split images from a raid1 LV and track changes to origin for later merge. .br .P \fBlvconvert\fP \fB--splitmirrors\fP \fINumber\fP \fB--trackchanges\fP \fILV\fP\fI_cache_raid1\fP @@ -722,6 +738,33 @@ Convert LV to type cache-pool. .RE - +Convert LV to type vdopool. +.br +.P +\fBlvconvert\fP \fB--type\fP \fBvdo-pool\fP \fILV\fP\fI_linear_striped_cache_raid\fP +.br +.RS 4 +.ad l +[ \fB-n\fP|\fB--name\fP \fILV\fP\fI_new\fP ] +.ad b +.br +.ad l +[ \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] ] +.ad b +.br +.ad l +[ \fB--compression\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--deduplication\fP \fBy\fP|\fBn\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +- + Separate and keep the cache pool from a cache LV. .br .P @@ -942,12 +985,7 @@ See \fBlvm\fP(8) for more information about allocation. .ad b .HP .ad l -\fB-b\fP|\fB--background\fP -.br -If the operation requires polling, this option causes the command to -return before the operation is complete, and polling is done in the -background. -.ad b +\fB-b\fP|\fB--background\fP.ad b .HP .ad l \fB-H\fP|\fB--cache\fP @@ -1027,6 +1065,13 @@ See \fBlvm.conf\fP(5) for more information about profiles. .ad b .HP .ad l +\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. +.ad b +.HP +.ad l \fB--config\fP \fIString\fP .br Config settings for the command. These override lvm.conf settings. @@ -1043,6 +1088,13 @@ messages sent to the log file and/or syslog (if configured). .ad b .HP .ad l +\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. +.ad b +.HP +.ad l \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP .br Specifies how the device-mapper thin pool layer in the kernel should @@ -1295,6 +1347,8 @@ Before the separation, the cache is flushed. Also see --uncache. Splits the specified number of images from a raid1 or mirror LV and uses them to create a new LV. If --trackchanges is also specified, changes to the raid1 LV are tracked while the split LV remains detached. +If --name is specified, then the images are permanently split from the +original LV and changes are not tracked. .ad b .HP .ad l @@ -1368,10 +1422,12 @@ The name of a thin pool LV. .br Can be used with --splitmirrors on a raid1 LV. This causes changes to the original raid1 LV to be tracked while the split images -remain detached. This allows the read-only detached image(s) to be -merged efficiently back into the raid1 LV later. Only the regions with -changed data are resynchronized during merge. (This option only applies -when using the raid1 LV type.) +remain detached. This is a temporary state that allows the read-only +detached image to be merged efficiently back into the raid1 LV later. +Only the regions with changed data are resynchronized during merge. +While a raid1 LV is tracking changes, operations on it are limited to +merging the split image (see --mergemirrors) or permanently splitting +the image (see --splitmirrors with --name. .ad b .HP .ad l @@ -1404,6 +1460,13 @@ or a profile. .ad b .HP .ad l +\fB--vdopool\fP \fILV\fP +.br +The name of a VDO pool LV. +See \fBlvmvdo\fP(7) for more information about VDO usage. +.ad b +.HP +.ad l \fB-v\fP|\fB--verbose\fP ... .br Set verbose level. Repeat from 1 to 4 times to increase the detail @@ -1417,6 +1480,23 @@ Display version information. .ad b .HP .ad l +\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. +lvm.conf global/sparse_segtype_default 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). +.ad b +.HP +.ad l \fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the @@ -1647,6 +1727,37 @@ Convert LV to type cache (infers --type cache). .br - +Convert LV to type vdopool. +.br +.P +\fBlvconvert\fP \fB--vdopool\fP \fILV\fP\fI_linear_striped_cache_raid\fP +.br +.RS 4 +.ad l +[ \fB-n\fP|\fB--name\fP \fILV\fP\fI_new\fP ] +.ad b +.br +.ad l +[ \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] ] +.ad b +.br +.ad l +[ \fB--type\fP \fBvdo-pool\fP ] +.ad b +.br +.ad l +[ \fB--compression\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--deduplication\fP \fBy\fP|\fBn\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +- + Separate and delete the cache pool from a cache LV. .br .P diff --git a/man/lvcreate.8_pregen b/man/lvcreate.8_pregen index b6483b5e4..7a2adb115 100644 --- a/man/lvcreate.8_pregen +++ b/man/lvcreate.8_pregen @@ -58,6 +58,10 @@ lvcreate - Create a logical volume \fB--commandprofile\fP \fIString\fP .ad b .br +.ad l + \fB--compression\fP \fBy\fP|\fBn\fP +.ad b +.br .ad l \fB--config\fP \fIString\fP .ad b @@ -70,6 +74,10 @@ lvcreate - Create a logical volume \fB-d\fP|\fB--debug\fP .ad b .br +.ad l + \fB--deduplication\fP \fBy\fP|\fBn\fP +.ad b +.br .ad l \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP .ad b @@ -226,6 +234,14 @@ lvcreate - Create a logical volume \fB--type\fP \fBlinear\fP|\fBstriped\fP|\fBsnapshot\fP|\fBmirror\fP|\fBraid\fP|\fBthin\fP|\fBcache\fP|\fBthin-pool\fP|\fBcache-pool\fP .ad b .br +.ad l + \fB--vdo\fP +.ad b +.br +.ad l + \fB--vdopool\fP \fILV\fP +.ad b +.br .ad l \fB-v\fP|\fB--verbose\fP .ad b @@ -286,10 +302,10 @@ 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. .SH USAGE -Create a linear LV. +Create an LV that returns VDO when used. .br .P -\fBlvcreate\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP +\fBlvcreate\fP \fB--type\fP \fBvdo\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP .br .RS 4 .ad l @@ -297,85 +313,55 @@ Create a linear LV. .ad b .br .ad l -[ \fB--type\fP \fBlinear\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE -.br -.RS 4 -[ \fIPV\fP ... ] -.RE -- - -Create a striped LV (infers --type striped). -.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-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE -.br -.RS 4 -[ \fIPV\fP ... ] -.RE -- - -Create a raid1 or mirror LV (infers --type raid1|mirror). -.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-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] .ad b .br .ad l -[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ] +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] .ad b .br .ad l -[ \fB--mirrorlog\fP \fBcore\fP|\fBdisk\fP ] +[ \fB-n\fP|\fB--name\fP \fIString\fP ] .ad b .br .ad l -[ \fB--[raid]minrecoveryrate\fP \fISize\fP[k|UNIT] ] +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] .ad b .br .ad l -[ \fB--[raid]maxrecoveryrate\fP \fISize\fP[k|UNIT] ] +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b .br -.RS 4 -[ \fIPV\fP ... ] -.RE -- - -Create a raid LV (a specific raid level must be used, e.g. raid1). +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b .br -.P -\fBlvcreate\fP \fB--type\fP \fBraid\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b .br -.RS 4 .ad l -[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-m\fP|\fB--mirrors\fP \fINumber\fP ] +[ \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l @@ -387,52 +373,51 @@ Create a raid LV (a specific raid level must be used, e.g. raid1). .ad b .br .ad l -[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ] +[ \fB--vdo\fP ] .ad b .br .ad l -[ \fB--[raid]minrecoveryrate\fP \fISize\fP[k|UNIT] ] +[ \fB--addtag\fP \fITag\fP ] .ad b .br .ad l -[ \fB--[raid]maxrecoveryrate\fP \fISize\fP[k|UNIT] ] +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b .br -.RS 4 -[ \fIPV\fP ... ] -.RE -- - -Create a raid10 LV. +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b .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 +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b .br -.RS 4 .ad l -[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB--nosync\fP ] .ad b .br .ad l -[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ] +[ \fB--noudevsync\fP ] .ad b .br .ad l -[ \fB--[raid]minrecoveryrate\fP \fISize\fP[k|UNIT] ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br .ad l -[ \fB--[raid]maxrecoveryrate\fP \fISize\fP[k|UNIT] ] +[ \fB--compression\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--deduplication\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -443,10 +428,10 @@ Create a raid10 LV. .RE - -Create a COW snapshot LV of an origin LV. +Create a linear LV. .br .P -\fBlvcreate\fP \fB-s\fP|\fB--snapshot\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fILV\fP +\fBlvcreate\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP .br .RS 4 .ad l @@ -454,119 +439,91 @@ Create a COW snapshot LV of an origin LV. .ad b .br .ad l -[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--type\fP \fBsnapshot\fP ] +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE -.br -.RS 4 -[ \fIPV\fP ... ] -.RE -- - -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] ] +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB-n\fP|\fB--name\fP \fIString\fP ] .ad b .br .ad l -[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--thinpool\fP \fILV\fP\fI_new\fP ] +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] .ad b .br .ad l -[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--type\fP \fBlinear\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE -.br -.RS 4 -[ \fIPV\fP ... ] -.RE -- - -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] ] +[ \fB--addtag\fP \fITag\fP ] .ad b .br .ad l -[ \fB-H\fP|\fB--cache\fP ] +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB--ignoremonitoring\fP ] .ad b .br .ad l -[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--metadataprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--minor\fP \fINumber\fP ] .ad b .br .ad l -[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--cachepolicy\fP \fIString\fP ] +[ \fB--nosync\fP ] .ad b .br .ad l -[ \fB--cachesettings\fP \fIString\fP ] +[ \fB--noudevsync\fP ] .ad b .br .ad l -[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -577,102 +534,116 @@ Create a cache pool. .RE - -Create a thin LV in a thin pool (infers --type thin). +Create a striped LV (infers --type striped). .br .P -\fBlvcreate\fP \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] \fB--thinpool\fP \fILV\fP\fI_thinpool\fP \fIVG\fP +\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-T\fP|\fB--thin\fP ] +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB--type\fP \fBthin\fP ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE -.br -- - -Create a thin LV that is a snapshot of an existing thin LV -.br -(infers --type thin). -.br -.P -\fBlvcreate\fP \fB-s\fP|\fB--snapshot\fP \fILV\fP\fI_thin\fP -.br -.RS 4 .ad l -[ \fB--type\fP \fBthin\fP ] +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] .ad b .br .ad l -[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE -.br -- - -Create a thin LV that is a snapshot of an external origin LV. +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b .br -.P -\fBlvcreate\fP \fB--type\fP \fBthin\fP \fB--thinpool\fP \fILV\fP\fI_thinpool\fP \fILV\fP +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b .br -.RS 4 .ad l -[ \fB-T\fP|\fB--thin\fP ] +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] .ad b .br .ad l -[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--addtag\fP \fITag\fP ] .ad b .br -[ COMMON_OPTIONS ] +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] .RE .br +.RS 4 +[ \fIPV\fP ... ] +.RE - -Create a thin LV, first creating a thin pool for it, -.br -where the new thin pool is named by the --thinpool arg. +Create a raid1 or mirror LV (infers --type raid1|mirror). .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 -.RE +\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 @@ -680,100 +651,103 @@ where the new thin pool is named by the --thinpool arg. .ad b .br .ad l -[ \fB-T\fP|\fB--thin\fP ] +[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] .ad b .br .ad l -[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] .ad b .br .ad l -[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB-n\fP|\fB--name\fP \fIString\fP ] .ad b .br .ad l -[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b .br -.RS 4 -[ \fIPV\fP ... ] -.RE -- - -Create a cache LV, first creating a new origin LV, +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b .br -then combining it with the existing cache pool named +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b .br -by the --cachepool arg. +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b .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\fI_cachepool\fP \fIVG\fP -.RE +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b .br -.RS 4 .ad l -[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +[ \fB--mirrorlog\fP \fBcore\fP|\fBdisk\fP ] .ad b .br .ad l -[ \fB-H\fP|\fB--cache\fP ] +[ \fB--[raid]minrecoveryrate\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB--[raid]maxrecoveryrate\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +[ \fB--addtag\fP \fITag\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] .ad b .br .ad l -[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--ignoremonitoring\fP ] .ad b .br .ad l -[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--metadataprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] +[ \fB--minor\fP \fINumber\fP ] .ad b .br .ad l -[ \fB--cachepolicy\fP \fIString\fP ] +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--cachesettings\fP \fIString\fP ] +[ \fB--nosync\fP ] .ad b .br .ad l -[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -784,11 +758,30 @@ by the --cachepool arg. .RE - -Common options for command: -. +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-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +.ad b +.br +.ad l +[ \fB-m\fP|\fB--mirrors\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l @@ -796,6 +789,10 @@ Common options for command: .ad b .br .ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l [ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] .ad b .br @@ -836,6 +833,14 @@ Common options for command: .ad b .br .ad l +[ \fB--[raid]minrecoveryrate\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB--[raid]maxrecoveryrate\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l [ \fB--addtag\fP \fITag\fP ] .ad b .br @@ -870,709 +875,1884 @@ Common options for command: .ad l [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +.RS 4 +[ \fIPV\fP ... ] .RE +- -Common options for lvm: -. +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-d\fP|\fB--debug\fP ] +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-h\fP|\fB--help\fP ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB-q\fP|\fB--quiet\fP ] +[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB-t\fP|\fB--test\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB--verbose\fP ] +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB--yes\fP ] +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--commandprofile\fP \fIString\fP ] +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] .ad b .br .ad l -[ \fB--config\fP \fIString\fP ] +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] .ad b .br .ad l -[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB-n\fP|\fB--name\fP \fIString\fP ] .ad b .br .ad l -[ \fB--lockopt\fP \fIString\fP ] +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] .ad b .br .ad l -[ \fB--longhelp\fP ] +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--nolocking\fP ] +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] .ad b .br .ad l -[ \fB--profile\fP \fIString\fP ] +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--version\fP ] +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] .ad b -.RE -.SH OPTIONS -.HP +.br .ad l -\fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b .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 lvm.conf activation/auto_activation_volume_list. -\fBay\fP implies --zero n and --wipesignatures n. -See \fBlvmlockd\fP(8) for more information about activation options for shared VGs. -See \fBclvmd\fP(8) for more information about activation options for clustered VGs. +.ad l +[ \fB--[raid]minrecoveryrate\fP \fISize\fP[k|UNIT] ] .ad b -.HP +.br .ad l -\fB--addtag\fP \fITag\fP +[ \fB--[raid]maxrecoveryrate\fP \fISize\fP[k|UNIT] ] +.ad b .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. +.ad l +[ \fB--addtag\fP \fITag\fP ] .ad b -.HP +.br .ad l -\fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.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 overriden 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. +.ad l +[ \fB--ignoremonitoring\fP ] .ad b -.HP +.br .ad l -\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. +[ \fB--metadataprofile\fP \fIString\fP ] .ad b -.HP +.br .ad l -\fB-H\fP|\fB--cache\fP +[ \fB--minor\fP \fINumber\fP ] +.ad b .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. +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] .ad b -.HP +.br .ad l -\fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP +[ \fB--nosync\fP ] +.ad b .br -Specifies the cache metadata format used by cache target. +.ad l +[ \fB--noudevsync\fP ] .ad b -.HP +.br .ad l -\fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b .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. +[ COMMON_OPTIONS ] +.RE +.br +.RS 4 +[ \fIPV\fP ... ] +.RE +- + +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-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b -.HP +.br .ad l -\fB--cachepolicy\fP \fIString\fP +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +.ad b .br -Specifies the cache policy for a cache LV. -See \fBlvmcache\fP(7) for more information. +.ad l +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b -.HP +.br .ad l -\fB--cachepool\fP \fILV\fP +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +.ad b .br -The name of a cache pool LV. +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b -.HP +.br .ad l -\fB--cachesettings\fP \fIString\fP +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b .br -Specifies tunable values for a cache LV in "Key = Value" form. -Repeat this option to specify multiple values. -(The default values should usually be adequate.) -The special string value \fBdefault\fP switches -settings back to their default kernel values and removes -them from the list of settings stored in LVM metadata. -See \fBlvmcache\fP(7) for more information. +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] .ad b -.HP +.br .ad l -\fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b .br -The size of chunks in a snapshot, cache pool or thin pool. -For snapshots, the value must be a power of 2 between 4KiB and 512KiB -and the default value is 4. -For a cache pool the value must be between 32KiB and 1GiB -and the default value is 64. -For a thin pool the value must be between 64KiB and 1GiB -and the default value starts with 64 and scales up to fit the -pool metadata size within 128MiB, if the pool metadata size is not specified. -The value must be a multiple of 64KiB. -See \fBlvmthin\fP(7) and \fBlvmcache\fP(7) for more information. +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] .ad b -.HP +.br .ad l -\fB--commandprofile\fP \fIString\fP +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b .br -The command profile to use for command configuration. -See \fBlvm.conf\fP(5) for more information about profiles. +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] .ad b -.HP +.br .ad l -\fB--config\fP \fIString\fP +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b .br -Config settings for the command. These override lvm.conf settings. -The String arg uses the same format as lvm.conf, -or may use section/field syntax. -See \fBlvm.conf\fP(5) for more information about config. +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] .ad b -.HP +.br .ad l -\fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b .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. +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] .ad b -.HP +.br .ad l -\fB-d\fP|\fB--debug\fP ... +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b .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). +.ad l +[ \fB--type\fP \fBsnapshot\fP ] .ad b -.HP +.br .ad l -\fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP +[ \fB--addtag\fP \fITag\fP ] +.ad b .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. +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] .ad b -.HP +.br .ad l -\fB--driverloaded\fP \fBy\fP|\fBn\fP +[ \fB--ignoremonitoring\fP ] +.ad b .br -If set to no, the command will not attempt to use device-mapper. -For testing and debugging. +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] .ad b -.HP +.br .ad l -\fB--errorwhenfull\fP \fBy\fP|\fBn\fP +[ \fB--minor\fP \fINumber\fP ] +.ad b .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. +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] .ad b -.HP +.br .ad l -\fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] +[ \fB--nosync\fP ] +.ad b .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. +.ad l +[ \fB--noudevsync\fP ] .ad b -.HP +.br .ad l -\fB-h\fP|\fB--help\fP +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b .br -Display help text. +[ COMMON_OPTIONS ] +.RE +.br +.RS 4 +[ \fIPV\fP ... ] +.RE +- + +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] ] .ad b -.HP +.br .ad l -\fB-K\fP|\fB--ignoreactivationskip\fP +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +.ad b .br -Ignore the "activation skip" LV flag during activation -to allow LVs with the flag set to be activated. +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b -.HP +.br .ad l -\fB--ignoremonitoring\fP +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b .br -Do not interact with dmeventd unless --monitor is specified. -Do not use this if dmeventd is already monitoring a device. +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] .ad b -.HP +.br .ad l -\fB--lockopt\fP \fIString\fP +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b .br -Used to pass options for special cases to lvmlockd. -See \fBlvmlockd\fP(8) for more information. +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] .ad b -.HP +.br .ad l -\fB--longhelp\fP +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b .br -Display long help text. +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] .ad b -.HP +.br .ad l -\fB-j\fP|\fB--major\fP \fINumber\fP +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b .br -Sets the major number of an LV block device. +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] .ad b -.HP +.br .ad l -\fB--[raid]maxrecoveryrate\fP \fISize\fP[k|UNIT] +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b .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. +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] .ad b -.HP +.br .ad l -\fB--metadataprofile\fP \fIString\fP +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b .br -The metadata profile to use for command configuration. -See \fBlvm.conf\fP(5) for more information about profiles. +.ad l +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b -.HP +.br .ad l -\fB--minor\fP \fINumber\fP +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +.ad b .br -Sets the minor number of an LV block device. +.ad l +[ \fB--thinpool\fP \fILV\fP\fI_new\fP ] .ad b -.HP +.br .ad l -\fB--[raid]minrecoveryrate\fP \fISize\fP[k|UNIT] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +.ad b .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. +.ad l +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b -.HP +.br .ad l -\fB--mirrorlog\fP \fBcore\fP|\fBdisk\fP +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +.ad b .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. +.ad l +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] .ad b -.HP +.br .ad l -\fB-m\fP|\fB--mirrors\fP \fINumber\fP +[ \fB--addtag\fP \fITag\fP ] +.ad b .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 lvm.conf global/mirror_segtype_default 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. +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] .ad b -.HP +.br .ad l -\fB--monitor\fP \fBy\fP|\fBn\fP +[ \fB--ignoremonitoring\fP ] +.ad b .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 reponse to specific events. -See \fBdmeventd\fP(8) for more information. +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] .ad b -.HP +.br .ad l -\fB-n\fP|\fB--name\fP \fIString\fP +[ \fB--minor\fP \fINumber\fP ] +.ad b .br -Specifies the name of a new LV. -When unspecified, a default name of "lvol#" is -generated, where # is a number generated by LVM. +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] .ad b -.HP +.br .ad l -\fB--nolocking\fP +[ \fB--nosync\fP ] +.ad b .br -Disable locking. +.ad l +[ \fB--noudevsync\fP ] .ad b -.HP +.br .ad l -\fB--nosync\fP +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b .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. +[ COMMON_OPTIONS ] +.RE +.br +.RS 4 +[ \fIPV\fP ... ] +.RE +- + +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] ] .ad b -.HP +.br .ad l -\fB--noudevsync\fP +[ \fB-H\fP|\fB--cache\fP ] +.ad b .br -Disables udev synchronisation. 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. +.ad l +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b -.HP +.br .ad l -\fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b .br -Set access permission to read only \fBr\fP or read and write \fBrw\fP. +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] .ad b -.HP +.br .ad l -\fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b .br -When yes, makes the specified minor number persistent. +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] .ad b -.HP +.br .ad l -\fB--poolmetadatasize\fP \fISize\fP[m|UNIT] +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b .br -Specifies the size of the new pool metadata LV. +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] .ad b -.HP +.br .ad l -\fB--poolmetadataspare\fP \fBy\fP|\fBn\fP +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b .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. +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] .ad b -.HP +.br .ad l -\fB--profile\fP \fIString\fP +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b .br -An alias for --commandprofile or --metadataprofile, depending -on the command. +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] .ad b -.HP +.br .ad l -\fB-q\fP|\fB--quiet\fP ... +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b .br -Suppress output and log messages. Overrides --debug and --verbose. -Repeat once to also suppress any prompts with answer 'no'. +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b -.HP +.br .ad l -\fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +.ad b .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. +.ad l +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b -.HP +.br .ad l -\fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] +[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] +.ad b .br -Size of each raid or mirror synchronization region. -lvm.conf activation/raid_region_size can be used to -configure a default. +.ad l +[ \fB--cachepolicy\fP \fIString\fP ] .ad b -.HP +.br .ad l -\fB--reportformat\fP \fBbasic\fP|\fBjson\fP +[ \fB--cachesettings\fP \fIString\fP ] +.ad b .br -Overrides current output format for reports which is defined globally by -the report/output_format setting in lvm.conf. -\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. See \fBlvmreport\fP(7) for more information. +.ad l +[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] .ad b -.HP +.br .ad l -\fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP +[ \fB--addtag\fP \fITag\fP ] +.ad b .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. +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] .ad b -.HP +.br .ad l -\fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] +[ \fB--ignoremonitoring\fP ] +.ad b .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. +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] .ad b -.HP +.br .ad l -\fB-s\fP|\fB--snapshot\fP +[ \fB--minor\fP \fINumber\fP ] +.ad b .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. +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] .ad b -.HP +.br .ad l -\fB-i\fP|\fB--stripes\fP \fINumber\fP +[ \fB--nosync\fP ] +.ad b .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 lvm.conf allocation/raid_stripe_all_devices. +.ad l +[ \fB--noudevsync\fP ] .ad b -.HP +.br .ad l -\fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b .br -The amount of data that is written to one device before -moving to the next in a striped LV. +[ COMMON_OPTIONS ] +.RE +.br +.RS 4 +[ \fIPV\fP ... ] +.RE +- + +Create a thin LV in a thin pool (infers --type thin). +.br +.P +\fBlvcreate\fP \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] \fB--thinpool\fP \fILV\fP\fI_thinpool\fP \fIVG\fP +.br +.RS 4 +.ad l +[ \fB-T\fP|\fB--thin\fP ] .ad b -.HP +.br .ad l -\fB-t\fP|\fB--test\fP +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b .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. +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] .ad b -.HP +.br .ad l -\fB-T\fP|\fB--thin\fP +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b .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. +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] .ad b -.HP +.br .ad l -\fB--thinpool\fP \fILV\fP +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b .br -The name of a thin pool LV. +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] .ad b -.HP +.br .ad l -\fB--type\fP \fBlinear\fP|\fBstriped\fP|\fBsnapshot\fP|\fBmirror\fP|\fBraid\fP|\fBthin\fP|\fBcache\fP|\fBthin-pool\fP|\fBcache-pool\fP +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.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, \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. -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). -Use inferred types with care because it can lead to unexpected results. +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] .ad b -.HP +.br .ad l -\fB-v\fP|\fB--verbose\fP ... +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b .br -Set verbose level. Repeat from 1 to 4 times to increase the detail -of messages sent to stdout and stderr. +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] .ad b -.HP +.br .ad l -\fB--version\fP +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b .br -Display version information. +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b -.HP +.br .ad l -\fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] +[ \fB--type\fP \fBthin\fP ] +.ad b .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. -lvm.conf global/sparse_segtype_default 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). +.ad l +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] .ad b -.HP +.br .ad l -\fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +.ad b .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 -lvm.conf allocation/wipe_signatures_when_zeroing_new_lvs. -If blkid wiping is used (lvm.conf allocation/use_blkid_wiping) -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. +.ad l +[ \fB--addtag\fP \fITag\fP ] .ad b -.HP +.br .ad l -\fB-y\fP|\fB--yes\fP +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b .br -Do not prompt for confirmation interactively but always assume the -answer yes. Use with extreme caution. -(For automatic no, see -qq.) +.ad l +[ \fB--ignoremonitoring\fP ] .ad b -.HP +.br .ad l -\fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b .br -Controls zeroing of the first 4KiB of data in the new LV. -Default is \fBy\fP. -Snapshot COW volumes are always zeroed. -LV is not zeroed if the read only flag is set. -Warning: trying to mount an unzeroed LV can cause the system to hang. +.ad l +[ \fB--minor\fP \fINumber\fP ] .ad b -.SH VARIABLES -.HP -\fIVG\fP .br -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. -.HP -\fILV\fP +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b .br -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. -LV followed by _ indicates that an LV of the -given type is required. (raid represents raid type) -.HP -\fIPV\fP +.ad l +[ \fB--nosync\fP ] +.ad b .br -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]... -.HP -\fIString\fP +.ad l +[ \fB--noudevsync\fP ] +.ad b .br -See the option description for information about the string content. -.HP -\fISize\fP[UNIT] +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b .br -Size is an input number that accepts an optional unit. -Input units are always treated as base two values, regardless of +[ COMMON_OPTIONS ] +.RE +.br +- + +Create a thin LV that is a snapshot of an existing thin LV +.br +(infers --type thin). +.br +.P +\fBlvcreate\fP \fB-s\fP|\fB--snapshot\fP \fILV\fP\fI_thin\fP +.br +.RS 4 +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--type\fP \fBthin\fP ] +.ad b +.br +.ad l +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +.ad b +.br +.ad l +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +- + +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\fI_thinpool\fP \fILV\fP +.br +.RS 4 +.ad l +[ \fB-T\fP|\fB--thin\fP ] +.ad b +.br +.ad l +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +.ad b +.br +.ad l +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +.ad b +.br +.ad l +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +- + +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 +.RE +.br +.RS 4 +.ad l +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +.ad b +.br +.ad l +[ \fB-T\fP|\fB--thin\fP ] +.ad b +.br +.ad l +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +.ad b +.br +.ad l +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +.ad b +.br +.ad l +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +.RS 4 +[ \fIPV\fP ... ] +.RE +- + +Create a cache LV, first creating a new origin LV, +.br +then combining it with the existing cache pool named +.br +by the --cachepool arg. +.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\fI_cachepool\fP \fIVG\fP +.RE +.br +.RS 4 +.ad l +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +.ad b +.br +.ad l +[ \fB-H\fP|\fB--cache\fP ] +.ad b +.br +.ad l +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +.ad b +.br +.ad l +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] +.ad b +.br +.ad l +[ \fB--cachepolicy\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--cachesettings\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +.RS 4 +[ \fIPV\fP ... ] +.RE +- + +Common options for command: +. +.RS 4 +.RE + +Common options for lvm: +. +.RS 4 +.ad l +[ \fB-d\fP|\fB--debug\fP ] +.ad b +.br +.ad l +[ \fB-h\fP|\fB--help\fP ] +.ad b +.br +.ad l +[ \fB-q\fP|\fB--quiet\fP ] +.ad b +.br +.ad l +[ \fB-t\fP|\fB--test\fP ] +.ad b +.br +.ad l +[ \fB-v\fP|\fB--verbose\fP ] +.ad b +.br +.ad l +[ \fB-y\fP|\fB--yes\fP ] +.ad b +.br +.ad l +[ \fB--commandprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--config\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--lockopt\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--longhelp\fP ] +.ad b +.br +.ad l +[ \fB--nolocking\fP ] +.ad b +.br +.ad l +[ \fB--profile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--version\fP ] +.ad b +.RE +.SH OPTIONS +.HP +.ad l +\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 lvm.conf activation/auto_activation_volume_list. +\fBay\fP implies --zero n and --wipesignatures n. +See \fBlvmlockd\fP(8) for more information about activation options for shared VGs. +See \fBclvmd\fP(8) for more information about activation options for clustered VGs. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP +.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 overriden 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. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP +.br +Specifies the cache metadata format used by cache target. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\fB--cachepolicy\fP \fIString\fP +.br +Specifies the cache policy for a cache LV. +See \fBlvmcache\fP(7) for more information. +.ad b +.HP +.ad l +\fB--cachepool\fP \fILV\fP +.br +The name of a cache pool LV. +.ad b +.HP +.ad l +\fB--cachesettings\fP \fIString\fP +.br +Specifies tunable values for a cache LV in "Key = Value" form. +Repeat this option to specify multiple values. +(The default values should usually be adequate.) +The special string value \fBdefault\fP switches +settings back to their default kernel values and removes +them from the list of settings stored in LVM metadata. +See \fBlvmcache\fP(7) for more information. +.ad b +.HP +.ad l +\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 4KiB and 512KiB +and the default value is 4. +For a cache pool the value must be between 32KiB and 1GiB +and the default value is 64. +For a thin pool the value must be between 64KiB and 1GiB +and the default value starts with 64 and scales up to fit the +pool metadata size within 128MiB, if the pool metadata size is not specified. +The value must be a multiple of 64KiB. +See \fBlvmthin\fP(7) and \fBlvmcache\fP(7) for more information. +.ad b +.HP +.ad l +\fB--commandprofile\fP \fIString\fP +.br +The command profile to use for command configuration. +See \fBlvm.conf\fP(5) for more information about profiles. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\fB--config\fP \fIString\fP +.br +Config settings for the command. These override lvm.conf settings. +The String arg uses the same format as lvm.conf, +or may use section/field syntax. +See \fBlvm.conf\fP(5) for more information about config. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\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). +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\fB-h\fP|\fB--help\fP +.br +Display help text. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\fB--ignoremonitoring\fP +.br +Do not interact with dmeventd unless --monitor is specified. +Do not use this if dmeventd is already monitoring a device. +.ad b +.HP +.ad l +\fB--lockopt\fP \fIString\fP +.br +Used to pass options for special cases to lvmlockd. +See \fBlvmlockd\fP(8) for more information. +.ad b +.HP +.ad l +\fB--longhelp\fP +.br +Display long help text. +.ad b +.HP +.ad l +\fB-j\fP|\fB--major\fP \fINumber\fP +.br +Sets the major number of an LV block device. +.ad b +.HP +.ad l +\fB--[raid]maxrecoveryrate\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. +.ad b +.HP +.ad l +\fB--metadataprofile\fP \fIString\fP +.br +The metadata profile to use for command configuration. +See \fBlvm.conf\fP(5) for more information about profiles. +.ad b +.HP +.ad l +\fB--minor\fP \fINumber\fP +.br +Sets the minor number of an LV block device. +.ad b +.HP +.ad l +\fB--[raid]minrecoveryrate\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. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\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 lvm.conf global/mirror_segtype_default 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. +.ad b +.HP +.ad l +\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 reponse to specific events. +See \fBdmeventd\fP(8) for more information. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\fB--nolocking\fP +.br +Disable locking. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\fB--noudevsync\fP +.br +Disables udev synchronisation. 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. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP +.br +When yes, makes the specified minor number persistent. +.ad b +.HP +.ad l +\fB--poolmetadatasize\fP \fISize\fP[m|UNIT] +.br +Specifies the size of the new pool metadata LV. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\fB--profile\fP \fIString\fP +.br +An alias for --commandprofile or --metadataprofile, depending +on the command. +.ad b +.HP +.ad l +\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'. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] +.br +Size of each raid or mirror synchronization region. +lvm.conf activation/raid_region_size can be used to +configure a default. +.ad b +.HP +.ad l +\fB--reportformat\fP \fBbasic\fP|\fBjson\fP +.br +Overrides current output format for reports which is defined globally by +the report/output_format setting in lvm.conf. +\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. See \fBlvmreport\fP(7) for more information. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\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 lvm.conf allocation/raid_stripe_all_devices. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\fB--thinpool\fP \fILV\fP +.br +The name of a thin pool LV. +.ad b +.HP +.ad l +\fB--type\fP \fBlinear\fP|\fBstriped\fP|\fBsnapshot\fP|\fBmirror\fP|\fBraid\fP|\fBthin\fP|\fBcache\fP|\fBthin-pool\fP|\fBcache-pool\fP +.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, \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. +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). +Use inferred types with care because it can lead to unexpected results. +.ad b +.HP +.ad l +\fB--vdo\fP +.br +Specifies the command is handling VDO LV. +See --type vdo. +See \fBlvmvdo\fP(7) for more information about VDO usage. +.ad b +.HP +.ad l +\fB--vdopool\fP \fILV\fP +.br +The name of a VDO pool LV. +See \fBlvmvdo\fP(7) for more information about VDO usage. +.ad b +.HP +.ad l +\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. +.ad b +.HP +.ad l +\fB--version\fP +.br +Display version information. +.ad b +.HP +.ad l +\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. +lvm.conf global/sparse_segtype_default 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). +.ad b +.HP +.ad l +\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 +lvm.conf allocation/wipe_signatures_when_zeroing_new_lvs. +If blkid wiping is used (lvm.conf allocation/use_blkid_wiping) +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. +.ad b +.HP +.ad l +\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.) +.ad b +.HP +.ad l +\fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP +.br +Controls zeroing of the first 4KiB of data in the new LV. +Default is \fBy\fP. +Snapshot COW volumes are always zeroed. +LV is not zeroed if the read only flag is set. +Warning: trying to mount an unzeroed LV can cause the system to hang. +.ad b +.SH VARIABLES +.HP +\fIVG\fP +.br +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. +.HP +\fILV\fP +.br +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. +LV followed by _ indicates that an LV of the +given type is required. (raid represents raid type) +.HP +\fIPV\fP +.br +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]... +.HP +\fIString\fP +.br +See the option description for information about the string content. +.HP +\fISize\fP[UNIT] +.br +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: \fBbBsSkKmMgGtTpPeE\fP. @@ -1587,70 +2767,2386 @@ For example, LVM_VG_NAME can generally be substituted for a required VG paramete .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. +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] ] +.ad b +.br +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +- + +Create an 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-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +.ad b +.br +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] ] +.ad b +.br +.ad l +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +.ad l +[ \fB--compression\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--deduplication\fP \fBy\fP|\fBn\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +.RS 4 +[ \fIPV\fP ... ] +.RE +- + +Create an VDO LV using existing VDO pool. +.br +.P +\fBlvcreate\fP \fB--vdopool\fP \fILV\fP \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] \fIVG\fP +.br +.RS 4 +.ad l +[ \fB--vdo\fP ] +.ad b +.br +.ad l +[ \fB--type\fP \fBvdo\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +.RS 4 +[ \fIPV\fP ... ] +.RE +- + +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] ] +.ad b +.br +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +- + +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] ] +.ad b +.br +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +.RS 4 +[ \fIPV\fP ... ] +.RE +- + +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] ] +.ad b +.br +.ad l +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +.RS 4 +[ \fIPV\fP ... ] +.RE +- + +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] ] +.ad b +.br +.ad l +[ \fB-m\fP|\fB--mirrors\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ] +.ad b +.br +.ad l +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--mirrorlog\fP \fBcore\fP|\fBdisk\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +.RS 4 +[ \fIPV\fP ... ] +.RE +- + +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] ] +.ad b +.br +.ad l +[ \fB-s\fP|\fB--snapshot\fP ] +.ad b +.br +.ad l +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +.RS 4 +[ \fIPV\fP ... ] +.RE +- + +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] ] +.ad b +.br +.ad l +[ \fB-s\fP|\fB--snapshot\fP ] +.ad b +.br +.ad l +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +.RS 4 +[ \fIPV\fP ... ] +.RE +- + +Create a sparse COW snapshot LV of a virtual origin LV. +.br +.P +\fBlvcreate\fP \fB-s\fP|\fB--snapshot\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] ] +.ad b +.br +.ad l +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--type\fP \fBsnapshot\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +.RS 4 +[ \fIPV\fP ... ] +.RE +- + +Create a thin pool (infers --type 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-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +.ad b +.br +.ad l +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB--type\fP \fBthin-pool\fP ] +.ad b +.br +.ad l +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +.ad b +.br +.ad l +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +.ad b +.br +.ad l +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +.RS 4 +[ \fIPV\fP ... ] +.RE +- + +Create a thin pool named by the --thinpool arg +.br +(infers --type thin-pool). +.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-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +.ad b +.br +.ad l +[ \fB-T\fP|\fB--thin\fP ] +.ad b +.br +.ad l +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB--type\fP \fBthin-pool\fP ] +.ad b +.br +.ad l +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +.ad b +.br +.ad l +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +.ad b +.br +.ad l +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +.RS 4 +[ \fIPV\fP ... ] +.RE +- + +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] ] +.ad b +.br +.ad l +[ \fB-H\fP|\fB--cache\fP ] +.ad b +.br +.ad l +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +.ad b +.br +.ad l +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] +.ad b +.br +.ad l +[ \fB--cachepolicy\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--cachesettings\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +.RS 4 +[ \fIPV\fP ... ] +.RE +- + +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\fI_thinpool\fP \fIVG\fP +.RE +.br +.RS 4 +.ad l +[ \fB-T\fP|\fB--thin\fP ] +.ad b +.br +.ad l +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +.ad b +.br +.ad l +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +.ad b +.br +.ad l +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +- + +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] \fILV\fP\fI_thinpool\fP +.br +.RS 4 +.ad l +[ \fB-T\fP|\fB--thin\fP ] +.ad b +.br +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +.ad b +.br +.ad l +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +- + +Create a thin LV in the thin pool named in the first arg +.br +(variant, infers --type thin, also see --thinpool for +.br +naming pool.) +.br +.P +\fBlvcreate\fP \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] \fILV\fP\fI_thinpool\fP +.br +.RS 4 +.ad l +[ \fB-T\fP|\fB--thin\fP ] +.ad b +.br +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--type\fP \fBthin\fP ] +.ad b +.br +.ad l +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +.ad b +.br +.ad l +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +- + +Create a thin LV that is a snapshot of an existing thin LV. +.br +.P +\fBlvcreate\fP \fB--type\fP \fBthin\fP \fILV\fP\fI_thin\fP +.br +.RS 4 +.ad l +[ \fB-T\fP|\fB--thin\fP ] +.ad b +.br +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +.ad b +.br +.ad l +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +- + +Create a thin LV that is a snapshot of an existing thin LV +.br +(infers --type thin). +.br +.P +\fBlvcreate\fP \fB-T\fP|\fB--thin\fP \fILV\fP\fI_thin\fP +.br +.RS 4 +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--type\fP \fBthin\fP ] +.ad b +.br +.ad l +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +.ad b +.br +.ad l +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +- + +Create a thin LV that is a snapshot of an external origin LV +.br +(infers --type thin). +.br +.P +\fBlvcreate\fP \fB-s\fP|\fB--snapshot\fP \fB--thinpool\fP \fILV\fP\fI_thinpool\fP \fILV\fP +.br +.RS 4 +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--type\fP \fBthin\fP ] +.ad b +.br +.ad l +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +.ad b +.br +.ad l +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +- + +Create a thin LV, first creating a thin pool for it, +.br +where the new thin pool is named by the --thinpool arg +.br +(variant, infers --type thin). +.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 +.RE +.br +.RS 4 +.ad l +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +.ad b +.br +.ad l +[ \fB-T\fP|\fB--thin\fP ] +.ad b +.br +.ad l +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +.ad b +.br +.ad l +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +.ad b +.br +.ad l +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b +.br +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b +.br +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b +.br +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] +.ad b +.br +[ COMMON_OPTIONS ] +.RE +.br +.RS 4 +[ \fIPV\fP ... ] +.RE +- + +Create a thin LV, first creating a thin pool for it, +.br +where the new thin pool is named by the --thinpool arg +.br +(variant, infers --type thin). +.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-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +.ad b +.br +.ad l +[ \fB-T\fP|\fB--thin\fP ] +.ad b +.br +.ad l +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +.ad b +.br +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b +.br +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b +.br +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b +.br +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b +.br +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b +.br +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b .br -.P -\fBlvcreate\fP \fB--type\fP \fBerror\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b .br -.RS 4 .ad l -[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b .br -- - -Create an LV that returns zeros when read. +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b .br -.P -\fBlvcreate\fP \fB--type\fP \fBzero\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP +.ad l +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +.ad b .br -.RS 4 .ad l -[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br -[ COMMON_OPTIONS ] -.RE +.ad l +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +.ad b .br -- - -Create a linear LV. +.ad l +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +.ad b .br -.P -\fBlvcreate\fP \fB--type\fP \fBlinear\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP +.ad l +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +.ad b .br -.RS 4 .ad l -[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE +.ad l +[ \fB--addtag\fP \fITag\fP ] +.ad b .br -.RS 4 -[ \fIPV\fP ... ] -.RE -- - -Create a striped LV (also see lvcreate --stripes). +.ad l +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] +.ad b .br -.P -\fBlvcreate\fP \fB--type\fP \fBstriped\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP +.ad l +[ \fB--ignoremonitoring\fP ] +.ad b .br -.RS 4 .ad l -[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +[ \fB--metadataprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +[ \fB--minor\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB--nosync\fP ] +.ad b +.br +.ad l +[ \fB--noudevsync\fP ] +.ad b +.br +.ad l +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -1661,10 +5157,19 @@ Create a striped LV (also see lvcreate --stripes). .RE - -Create a mirror LV (also see --type raid1). +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 \fBmirror\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP +\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 @@ -1672,47 +5177,59 @@ Create a mirror LV (also see --type raid1). .ad b .br .ad l -[ \fB-m\fP|\fB--mirrors\fP \fINumber\fP ] +[ \fB-T\fP|\fB--thin\fP ] .ad b .br .ad l -[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ] +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] .ad b .br .ad l -[ \fB--mirrorlog\fP \fBcore\fP|\fBdisk\fP ] +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b .br -.RS 4 -[ \fIPV\fP ... ] -.RE -- - -Create a COW snapshot LV of an origin LV +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b .br -(also see --snapshot). +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b .br -.P -\fBlvcreate\fP \fB--type\fP \fBsnapshot\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fILV\fP +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b .br -.RS 4 .ad l -[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-s\fP|\fB--snapshot\fP ] +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b +.br +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b +.br +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l @@ -1724,67 +5241,55 @@ Create a COW snapshot LV of an origin LV .ad b .br .ad l -[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br -[ COMMON_OPTIONS ] -.RE -.br -.RS 4 -[ \fIPV\fP ... ] -.RE -- - -Create a sparse COW snapshot LV of a virtual origin LV +.ad l +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +.ad b .br -(also see --snapshot). +.ad l +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +.ad b .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 +.ad l +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +.ad b .br -.RS 4 .ad l -[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +[ \fB--addtag\fP \fITag\fP ] .ad b .br .ad l -[ \fB-s\fP|\fB--snapshot\fP ] +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB--ignoremonitoring\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b .br -.RS 4 -[ \fIPV\fP ... ] -.RE -- - -Create a sparse COW snapshot LV of a virtual origin LV. +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b .br -.P -\fBlvcreate\fP \fB-s\fP|\fB--snapshot\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 +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b .br -.RS 4 .ad l -[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +[ \fB--nosync\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB--noudevsync\fP ] .ad b .br .ad l -[ \fB--type\fP \fBsnapshot\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -1795,10 +5300,19 @@ Create a sparse COW snapshot LV of a virtual origin LV. .RE - -Create a thin pool (infers --type thin-pool). +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 (variant, infers --type thin). .br .P -\fBlvcreate\fP \fB-T\fP|\fB--thin\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP +\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 @@ -1810,71 +5324,59 @@ Create a thin pool (infers --type thin-pool). .ad b .br .ad l -[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] .ad b .br .ad l -[ \fB--type\fP \fBthin-pool\fP ] +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] .ad b .br .ad l -[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] .ad b .br .ad l -[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB-n\fP|\fB--name\fP \fIString\fP ] .ad b .br .ad l -[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE -.br -.RS 4 -[ \fIPV\fP ... ] -.RE -- - -Create a thin pool named by the --thinpool arg -.br -(infers --type thin-pool). -.br -.P -\fBlvcreate\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fB--thinpool\fP \fILV\fP\fI_new\fP \fIVG\fP +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b .br -.RS 4 .ad l -[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] .ad b .br .ad l -[ \fB-T\fP|\fB--thin\fP ] +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB--type\fP \fBthin-pool\fP ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l @@ -1893,59 +5395,40 @@ Create a thin pool named by the --thinpool arg [ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE -.br -.RS 4 -[ \fIPV\fP ... ] -.RE -- - -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] ] +[ \fB--addtag\fP \fITag\fP ] .ad b .br .ad l -[ \fB-H\fP|\fB--cache\fP ] +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB--ignoremonitoring\fP ] .ad b .br .ad l -[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--metadataprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--minor\fP \fINumber\fP ] .ad b .br .ad l -[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--cachepolicy\fP \fIString\fP ] +[ \fB--nosync\fP ] .ad b .br .ad l -[ \fB--cachesettings\fP \fIString\fP ] +[ \fB--noudevsync\fP ] .ad b .br .ad l -[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -1956,85 +5439,100 @@ Create a cache pool named by the --cachepool arg .RE - -Create a thin LV in a thin pool. +Create a thin LV, first creating a thin pool for it +.br +(infers --type thin). +.br +Create a sparse snapshot of a virtual origin LV +.br +(infers --type snapshot). +.br +Chooses --type thin or --type snapshot according to +.br +config setting sparse_segtype_default. .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\fI_thinpool\fP \fIVG\fP -.RE +\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-T\fP|\fB--thin\fP ] +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB-s\fP|\fB--snapshot\fP ] .ad b .br .ad l -[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] .ad b .br .ad l -[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b .br -- - -Create a thin LV in a thin pool named in the first arg +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b .br -(variant, also see --thinpool for naming pool). +.ad l +[ \fB-n\fP|\fB--name\fP \fIString\fP ] +.ad b .br -.P -\fBlvcreate\fP \fB--type\fP \fBthin\fP \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] \fILV\fP\fI_thinpool\fP +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b .br -.RS 4 .ad l -[ \fB-T\fP|\fB--thin\fP ] +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] .ad b .br .ad l -[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE +.ad l +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] +.ad b .br -- - -Create a thin LV in the thin pool named in the first arg +.ad l +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] +.ad b .br -(variant, infers --type thin, also see --thinpool for +.ad l +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +.ad b .br -naming pool.) +.ad l +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +.ad b .br -.P -\fBlvcreate\fP \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] \fILV\fP\fI_thinpool\fP +.ad l +[ \fB--type\fP \fBsnapshot\fP ] +.ad b .br -.RS 4 .ad l -[ \fB-T\fP|\fB--thin\fP ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB--type\fP \fBthin\fP ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l @@ -2045,188 +5543,182 @@ naming pool.) [ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE -.br -- - -Create a thin LV that is a snapshot of an existing thin LV. -.br -.P -\fBlvcreate\fP \fB--type\fP \fBthin\fP \fILV\fP\fI_thin\fP -.br -.RS 4 .ad l -[ \fB-T\fP|\fB--thin\fP ] +[ \fB--addtag\fP \fITag\fP ] .ad b .br .ad l -[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] .ad b .br .ad l -[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--ignoremonitoring\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE -.br -- - -Create a thin LV that is a snapshot of an existing thin LV +.ad l +[ \fB--metadataprofile\fP \fIString\fP ] +.ad b .br -(infers --type thin). +.ad l +[ \fB--minor\fP \fINumber\fP ] +.ad b .br -.P -\fBlvcreate\fP \fB-T\fP|\fB--thin\fP \fILV\fP\fI_thin\fP +.ad l +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] +.ad b .br -.RS 4 .ad l -[ \fB--type\fP \fBthin\fP ] +[ \fB--nosync\fP ] .ad b .br .ad l -[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB--noudevsync\fP ] .ad b .br .ad l -[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br [ COMMON_OPTIONS ] .RE .br +.RS 4 +[ \fIPV\fP ... ] +.RE - -Create a thin LV that is a snapshot of an external origin LV +Create a cache LV, first creating a new origin LV, .br -(infers --type thin). +then combining it with the existing cache pool named +.br +by the --cachepool arg (variant, infers --type cache). .br .P -\fBlvcreate\fP \fB-s\fP|\fB--snapshot\fP \fB--thinpool\fP \fILV\fP\fI_thinpool\fP \fILV\fP +\fBlvcreate\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fB--cachepool\fP \fILV\fP\fI_cachepool\fP \fIVG\fP .br .RS 4 .ad l -[ \fB--type\fP \fBthin\fP ] +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB-H\fP|\fB--cache\fP ] .ad b .br .ad l -[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br -[ COMMON_OPTIONS ] -.RE +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.ad b .br -- - -Create a thin LV, first creating a thin pool for it, +.ad l +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +.ad b .br -where the new thin pool is named by the --thinpool arg +.ad l +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] +.ad b .br -(variant, infers --type thin). +.ad l +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] +.ad b .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 -.RE +.ad l +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] +.ad b .br -.RS 4 .ad l -[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +[ \fB-n\fP|\fB--name\fP \fIString\fP ] .ad b .br .ad l -[ \fB-T\fP|\fB--thin\fP ] +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br -[ COMMON_OPTIONS ] -.RE +.ad l +[ \fB--type\fP \fBcache\fP ] +.ad b .br -.RS 4 -[ \fIPV\fP ... ] -.RE -- - -Create a thin LV, first creating a thin pool for it, +.ad l +[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] +.ad b .br -where the new thin pool is named by the --thinpool arg +.ad l +[ \fB--cachepolicy\fP \fIString\fP ] +.ad b .br -(variant, infers --type thin). +.ad l +[ \fB--cachesettings\fP \fIString\fP ] +.ad b .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 +.ad l +[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] +.ad b .br -.RS 4 .ad l -[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +[ \fB--addtag\fP \fITag\fP ] .ad b .br .ad l -[ \fB-T\fP|\fB--thin\fP ] +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB--ignoremonitoring\fP ] .ad b .br .ad l -[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +[ \fB--metadataprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB--minor\fP \fINumber\fP ] .ad b .br .ad l -[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--nosync\fP ] .ad b .br .ad l -[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB--noudevsync\fP ] .ad b .br .ad l -[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -2237,19 +5729,14 @@ where the new thin pool is named by the --thinpool arg .RE - -Create a thin LV, first creating a thin pool for it, -.br -where the new thin pool is named in the first arg, +Create a cache LV, first creating a new origin LV, .br -or the new thin pool name is generated when the first +then combining it with the existing cache pool named .br -arg is a VG name. +in the first arg (variant, also use --cachepool). .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 +\fBlvcreate\fP \fB--type\fP \fBcache\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fILV\fP\fI_cachepool\fP .br .RS 4 .ad l @@ -2257,7 +5744,7 @@ arg is a VG name. .ad b .br .ad l -[ \fB-T\fP|\fB--thin\fP ] +[ \fB-H\fP|\fB--cache\fP ] .ad b .br .ad l @@ -2265,58 +5752,51 @@ arg is a VG name. .ad b .br .ad l -[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] .ad b .br .ad l -[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] .ad b .br .ad l -[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] .ad b .br .ad l -[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB-n\fP|\fB--name\fP \fIString\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE -.br -.RS 4 -[ \fIPV\fP ... ] -.RE -- - -Create a thin LV, first creating a thin pool for it, -.br -where the new thin pool is named in the first arg, +.ad l +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] +.ad b .br -or the new thin pool name is generated when the first +.ad l +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] +.ad b .br -arg is a VG name (variant, infers --type thin). +.ad l +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] +.ad b .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 +.ad l +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] +.ad b .br -.RS 4 .ad l -[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l @@ -2336,75 +5816,55 @@ arg is a VG name (variant, infers --type thin). .ad b .br .ad l -[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] .ad b .br .ad l -[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--cachepolicy\fP \fIString\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE -.br -.RS 4 -[ \fIPV\fP ... ] -.RE -- - -Create a thin LV, first creating a thin pool for it -.br -(infers --type thin). -.br -Create a sparse snapshot of a virtual origin LV -.br -(infers --type snapshot). -.br -Chooses --type thin or --type 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 +.ad l +[ \fB--cachesettings\fP \fIString\fP ] +.ad b .br -.RS 4 .ad l -[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] .ad b .br .ad l -[ \fB-s\fP|\fB--snapshot\fP ] +[ \fB--addtag\fP \fITag\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] .ad b .br .ad l -[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +[ \fB--ignoremonitoring\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB--metadataprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB--type\fP \fBsnapshot\fP ] +[ \fB--minor\fP \fINumber\fP ] .ad b .br .ad l -[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--nosync\fP ] .ad b .br .ad l -[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB--noudevsync\fP ] .ad b .br .ad l -[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -2415,14 +5875,22 @@ config setting sparse_segtype_default. .RE - -Create a cache LV, first creating a new origin LV, +When LV is a cache pool, create a cache LV, .br -then combining it with the existing cache pool named +first creating a new origin LV, then combining it with .br -by the --cachepool arg (variant, infers --type cache). +the existing cache pool named in the first arg +.br +(variant, infers --type cache, also use --cachepool). +.br +When LV is not a cache pool, convert the specified LV +.br +to type cache after creating a new cache pool LV to use +.br +(use lvconvert). .br .P -\fBlvcreate\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fB--cachepool\fP \fILV\fP\fI_cachepool\fP \fIVG\fP +\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 @@ -2430,85 +5898,63 @@ by the --cachepool arg (variant, infers --type cache). .ad b .br .ad l -[ \fB-H\fP|\fB--cache\fP ] -.ad b -.br -.ad l [ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] .ad b .br .ad l -[ \fB--type\fP \fBcache\fP ] +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] .ad b .br .ad l -[ \fB--cachepolicy\fP \fIString\fP ] +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] .ad b .br .ad l -[ \fB--cachesettings\fP \fIString\fP ] +[ \fB-n\fP|\fB--name\fP \fIString\fP ] .ad b .br .ad l -[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] +[ \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE -.br -.RS 4 -[ \fIPV\fP ... ] -.RE -- - -Create a cache LV, first creating a new origin LV, -.br -then combining it with the existing cache pool named -.br -in the first arg (variant, also use --cachepool). -.br -.P -\fBlvcreate\fP \fB--type\fP \fBcache\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fILV\fP\fI_cachepool\fP -.br -.RS 4 .ad l -[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +[ \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-H\fP|\fB--cache\fP ] +[ \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +[ \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l @@ -2527,70 +5973,48 @@ in the first arg (variant, also use --cachepool). [ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE -.br -.RS 4 -[ \fIPV\fP ... ] -.RE -- - -When LV is a cache pool, create a cache LV, -.br -first creating a new origin LV, then combining it with -.br -the existing cache pool named in the first arg -.br -(variant, infers --type cache, also use --cachepool). -.br -When LV is not a cache pool, convert the specified LV -.br -to type cache after creating a new cache pool LV to use -.br -(use lvconvert). -.br -.P -\fBlvcreate\fP \fB-H\fP|\fB--cache\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fILV\fP +.ad l +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +.ad b .br -.RS 4 .ad l -[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB--addtag\fP \fITag\fP ] .ad b .br .ad l -[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB--ignoremonitoring\fP ] .ad b .br .ad l -[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] +[ \fB--metadataprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB--cachepolicy\fP \fIString\fP ] +[ \fB--minor\fP \fINumber\fP ] .ad b .br .ad l -[ \fB--cachesettings\fP \fIString\fP ] +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] +[ \fB--nosync\fP ] .ad b .br .ad l -[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--noudevsync\fP ] .ad b .br .ad l -[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br [ COMMON_OPTIONS ] diff --git a/man/lvscan.8_pregen b/man/lvscan.8_pregen index 489286ef8..2d4fd6b63 100644 --- a/man/lvscan.8_pregen +++ b/man/lvscan.8_pregen @@ -3,11 +3,9 @@ lvscan - List all logical volumes in all volume groups . .SH SYNOPSIS -\fBlvscan\fP \fIoption_args\fP +\fBlvscan\fP .br [ \fIoption_args\fP ] -.br - [ \fIposition_args\fP ] .br .SH DESCRIPTION lvscan scans all VGs or all supported LVM block devices in the system for @@ -23,23 +21,6 @@ comprehensive information about LVs. [ \fB-a\fP|\fB--all\fP ] .ad b .br -[ COMMON_OPTIONS ] -.RE -.br - -\fBlvscan\fP \fB--cache\fP -.br -.RS 4 -[ COMMON_OPTIONS ] -.RE -.br -.RS 4 -[ \fILV\fP ... ] -.RE - -Common options for command: -. -.RS 4 .ad l [ \fB-b\fP|\fB--blockdevice\fP ] .ad b @@ -55,7 +36,10 @@ Common options for command: .ad l [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b +.br +[ COMMON_OPTIONS ] .RE +.br Common options for lvm: . @@ -133,12 +117,6 @@ No longer used. .ad b .HP .ad l -\fB--cache\fP -.br -Scan the devices used by an LV and send the metadata to lvmetad. -.ad b -.HP -.ad l \fB--commandprofile\fP \fIString\fP .br The command profile to use for command configuration. @@ -271,11 +249,6 @@ answer yes. Use with extreme caution. .ad b .SH VARIABLES .HP -\fILV\fP -.br -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. -.HP \fIString\fP .br See the option description for information about the string content. diff --git a/man/pvmove.8_pregen b/man/pvmove.8_pregen index e553722a9..16bbe9459 100644 --- a/man/pvmove.8_pregen +++ b/man/pvmove.8_pregen @@ -195,12 +195,7 @@ Enabling this is strongly advised! See \fBvgcfgbackup\fP(8) for more information .ad b .HP .ad l -\fB-b\fP|\fB--background\fP -.br -If the operation requires polling, this option causes the command to -return before the operation is complete, and polling is done in the -background. -.ad b +\fB-b\fP|\fB--background\fP.ad b .HP .ad l \fB--commandprofile\fP \fIString\fP diff --git a/man/pvscan.8_pregen b/man/pvscan.8_pregen index 3ce59b5d4..2326ec55e 100644 --- a/man/pvscan.8_pregen +++ b/man/pvscan.8_pregen @@ -129,7 +129,7 @@ Display PV information. .RE .br -Populate the lvmetad cache by scanning PVs. +Autoactivate a VG when all PVs are online. .br .P \fBpvscan\fP \fB--cache\fP @@ -239,17 +239,12 @@ Auto-activate LVs in a VG when the PVs scanned have completed the VG. .ad b .HP .ad l -\fB-b\fP|\fB--background\fP -.br -If the operation requires polling, this option causes the command to -return before the operation is complete, and polling is done in the -background. -.ad b +\fB-b\fP|\fB--background\fP.ad b .HP .ad l \fB--cache\fP .br -Scan one or more devices and send the metadata to lvmetad. +Scan one or more devices and record that they are online. .ad b .HP .ad l diff --git a/man/vgchange.8_pregen b/man/vgchange.8_pregen index 94dbd88a6..e1fcb816b 100644 --- a/man/vgchange.8_pregen +++ b/man/vgchange.8_pregen @@ -142,6 +142,10 @@ vgchange - Change volume group attributes \fB-q\fP|\fB--quiet\fP .ad b .br +.ad l + \fB--readonly\fP +.ad b +.br .ad l \fB--refresh\fP .ad b @@ -417,6 +421,10 @@ Activate or deactivate LVs. .ad b .br .ad l +[ \fB--readonly\fP ] +.ad b +.br +.ad l [ \fB--ignorelockingfailure\fP ] .ad b .br @@ -920,6 +928,20 @@ Repeat once to also suppress any prompts with answer 'no'. .ad b .HP .ad l +\fB--readonly\fP +.br +Run the command in a special read-only mode which will read on-disk +metadata without needing to take any locks. This can be used to peek +inside metadata used by a virtual machine image while the virtual +machine is running. +It can also be used to peek inside the metadata of clustered VGs +when clustered locking is not configured or running. No attempt +will be made to communicate with the device-mapper kernel driver, so +this option is unable to report whether or not LVs are +actually in use. +.ad b +.HP +.ad l \fB--refresh\fP .br If the LV is active, reload its metadata. @@ -968,7 +990,6 @@ available. As such, some functionality needs to be disabled and this option acts as a shortcut which selects an appropriate set of options. Currently, this is equivalent to using --ignorelockingfailure, --ignoremonitoring, --poll n, and setting env var LVM_SUPPRESS_LOCKING_FAILURE_MESSAGES. -When used in conjunction with lvmetad enabled and running, vgchange/lvchange skip autoactivation, and defer to pvscan autoactivation. .ad b .HP diff --git a/man/vgscan.8_pregen b/man/vgscan.8_pregen index fe9f20153..7fe3713fb 100644 --- a/man/vgscan.8_pregen +++ b/man/vgscan.8_pregen @@ -14,10 +14,6 @@ vgscan scans all supported LVM block devices in the system for VGs. .br .RS 4 .ad l -[ \fB--cache\fP ] -.ad b -.br -.ad l [ \fB--ignorelockingfailure\fP ] .ad b .br @@ -99,12 +95,6 @@ Common options for lvm: .SH OPTIONS .HP .ad l -\fB--cache\fP -.br -Scan all devices and send the metadata to lvmetad. -.ad b -.HP -.ad l \fB--commandprofile\fP \fIString\fP .br The command profile to use for command configuration. -- 2.43.5