diff --git a/man/lvchange.8_pregen b/man/lvchange.8_pregen index 726a89ffa..199e4cce0 100644 --- a/man/lvchange.8_pregen +++ b/man/lvchange.8_pregen @@ -1,6 +1,6 @@ .TH LVCHANGE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -lvchange \- Change the attributes of logical volume(s) +lvchange - Change the attributes of logical volume(s) . .SH SYNOPSIS \fBlvchange\fP \fIoption_args\fP \fIposition_args\fP @@ -9,215 +9,215 @@ lvchange \- Change the attributes of logical volume(s) .br .P .ad l - \fB-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP + \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP .ad b .br .ad l - \fB\-\-activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP + \fB--activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP .ad b .br .ad l - \fB\-\-addtag\fP \fITag\fP + \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 + \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP .ad b .br .ad l - \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP + \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB\-\-cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP + \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP .ad b .br .ad l - \fB\-\-cachepolicy\fP \fIString\fP + \fB--cachepolicy\fP \fIString\fP .ad b .br .ad l - \fB\-\-cachesettings\fP \fIString\fP + \fB--cachesettings\fP \fIString\fP .ad b .br .ad l - \fB\-\-commandprofile\fP \fIString\fP + \fB--commandprofile\fP \fIString\fP .ad b .br .ad l - \fB\-\-config\fP \fIString\fP + \fB--config\fP \fIString\fP .ad b .br .ad l - \fB-C\fP|\fB\-\-contiguous\fP \fBy\fP|\fBn\fP + \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB-d\fP|\fB\-\-debug\fP + \fB-d\fP|\fB--debug\fP .ad b .br .ad l - \fB\-\-deltag\fP \fITag\fP + \fB--deltag\fP \fITag\fP .ad b .br .ad l - \fB\-\-detachprofile\fP + \fB--detachprofile\fP .ad b .br .ad l - \fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP + \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP .ad b .br .ad l - \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP + \fB--driverloaded\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB\-\-errorwhenfull\fP \fBy\fP|\fBn\fP + \fB--errorwhenfull\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB-f\fP|\fB\-\-force\fP + \fB-f\fP|\fB--force\fP .ad b .br .ad l - \fB-h\fP|\fB\-\-help\fP + \fB-h\fP|\fB--help\fP .ad b .br .ad l - \fB-K\fP|\fB\-\-ignoreactivationskip\fP + \fB-K\fP|\fB--ignoreactivationskip\fP .ad b .br .ad l - \fB\-\-ignorelockingfailure\fP + \fB--ignorelockingfailure\fP .ad b .br .ad l - \fB\-\-ignoremonitoring\fP + \fB--ignoremonitoring\fP .ad b .br .ad l - \fB\-\-ignoreskippedcluster\fP + \fB--ignoreskippedcluster\fP .ad b .br .ad l - \fB\-\-longhelp\fP + \fB--longhelp\fP .ad b .br .ad l - \fB-j\fP|\fB\-\-major\fP \fINumber\fP + \fB-j\fP|\fB--major\fP \fINumber\fP .ad b .br .ad l - \fB\-\-[raid]maxrecoveryrate\fP \fISize\fP[k|UNIT] + \fB--[raid]maxrecoveryrate\fP \fISize\fP[k|UNIT] .ad b .br .ad l - \fB\-\-metadataprofile\fP \fIString\fP + \fB--metadataprofile\fP \fIString\fP .ad b .br .ad l - \fB\-\-minor\fP \fINumber\fP + \fB--minor\fP \fINumber\fP .ad b .br .ad l - \fB\-\-[raid]minrecoveryrate\fP \fISize\fP[k|UNIT] + \fB--[raid]minrecoveryrate\fP \fISize\fP[k|UNIT] .ad b .br .ad l - \fB\-\-monitor\fP \fBy\fP|\fBn\fP + \fB--monitor\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB\-\-noudevsync\fP + \fB--noudevsync\fP .ad b .br .ad l - \fB-P\fP|\fB\-\-partial\fP + \fB-P\fP|\fB--partial\fP .ad b .br .ad l - \fB-p\fP|\fB\-\-permission\fP \fBrw\fP|\fBr\fP + \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 + \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB\-\-poll\fP \fBy\fP|\fBn\fP + \fB--poll\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB\-\-profile\fP \fIString\fP + \fB--profile\fP \fIString\fP .ad b .br .ad l - \fB-q\fP|\fB\-\-quiet\fP + \fB-q\fP|\fB--quiet\fP .ad b .br .ad l - \fB-r\fP|\fB\-\-readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP + \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP .ad b .br .ad l - \fB\-\-rebuild\fP \fIPV\fP + \fB--rebuild\fP \fIPV\fP .ad b .br .ad l - \fB\-\-refresh\fP + \fB--refresh\fP .ad b .br .ad l - \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP + \fB--reportformat\fP \fBbasic\fP|\fBjson\fP .ad b .br .ad l - \fB\-\-resync\fP + \fB--resync\fP .ad b .br .ad l - \fB-S\fP|\fB\-\-select\fP \fIString\fP + \fB-S\fP|\fB--select\fP \fIString\fP .ad b .br .ad l - \fB-k\fP|\fB\-\-setactivationskip\fP \fBy\fP|\fBn\fP + \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB\-\-[raid]syncaction\fP \fBcheck\fP|\fBrepair\fP + \fB--[raid]syncaction\fP \fBcheck\fP|\fBrepair\fP .ad b .br .ad l - \fB\-\-sysinit\fP + \fB--sysinit\fP .ad b .br .ad l - \fB-t\fP|\fB\-\-test\fP + \fB-t\fP|\fB--test\fP .ad b .br .ad l - \fB-v\fP|\fB\-\-verbose\fP + \fB-v\fP|\fB--verbose\fP .ad b .br .ad l - \fB\-\-version\fP + \fB--version\fP .ad b .br .ad l - \fB\-\-[raid]writebehind\fP \fINumber\fP + \fB--[raid]writebehind\fP \fINumber\fP .ad b .br .ad l - \fB\-\-[raid]writemostly\fP \fIPV\fP[\fB:t\fP|\fBn\fP|\fBy\fP] + \fB--[raid]writemostly\fP \fIPV\fP[\fB:t\fP|\fBn\fP|\fBy\fP] .ad b .br .ad l - \fB-y\fP|\fB\-\-yes\fP + \fB-y\fP|\fB--yes\fP .ad b .br .ad l - \fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP + \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP .ad b .SH DESCRIPTION lvchange changes LV attributes in the VG, changes LV activation in the @@ -232,87 +232,87 @@ required, after which the others are optional. .P \fBlvchange\fP .RS 4 -( \fB-C\fP|\fB\-\-contiguous\fP \fBy\fP|\fBn\fP, +( \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP, .ad b .br .ad l - \fB-p\fP|\fB\-\-permission\fP \fBrw\fP|\fBr\fP, + \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP, .ad b .br .ad l - \fB-r\fP|\fB\-\-readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\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, + \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP, .ad b .br .ad l - \fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP, + \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP, .ad b .br .ad l - \fB-M\fP|\fB\-\-persistent\fP \fBn\fP, + \fB-M\fP|\fB--persistent\fP \fBn\fP, .ad b .br .ad l - \fB\-\-addtag\fP \fITag\fP, + \fB--addtag\fP \fITag\fP, .ad b .br .ad l - \fB\-\-deltag\fP \fITag\fP, + \fB--deltag\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, + \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP, .ad b .br .ad l - \fB\-\-detachprofile\fP, + \fB--detachprofile\fP, .ad b .br .ad l - \fB\-\-metadataprofile\fP \fIString\fP, + \fB--metadataprofile\fP \fIString\fP, .ad b .br .ad l - \fB\-\-profile\fP \fIString\fP, + \fB--profile\fP \fIString\fP, .ad b .br .ad l - \fB\-\-errorwhenfull\fP \fBy\fP|\fBn\fP, + \fB--errorwhenfull\fP \fBy\fP|\fBn\fP, .ad b .br .ad l - \fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP, + \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP, .ad b .br .ad l - \fB\-\-cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP, + \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP, .ad b .br .ad l - \fB\-\-cachepolicy\fP \fIString\fP, + \fB--cachepolicy\fP \fIString\fP, .ad b .br .ad l - \fB\-\-cachesettings\fP \fIString\fP, + \fB--cachesettings\fP \fIString\fP, .ad b .br .ad l - \fB\-\-[raid]minrecoveryrate\fP \fISize\fP[k|UNIT], + \fB--[raid]minrecoveryrate\fP \fISize\fP[k|UNIT], .ad b .br .ad l - \fB\-\-[raid]maxrecoveryrate\fP \fISize\fP[k|UNIT], + \fB--[raid]maxrecoveryrate\fP \fISize\fP[k|UNIT], .ad b .br .ad l - \fB\-\-[raid]writebehind\fP \fINumber\fP, + \fB--[raid]writebehind\fP \fINumber\fP, .ad b .br .ad l - \fB\-\-[raid]writemostly\fP \fIPV\fP[\fB:t\fP|\fBn\fP|\fBy\fP] ) + \fB--[raid]writemostly\fP \fIPV\fP[\fB:t\fP|\fBn\fP|\fBy\fP] ) .RE .RS 4 \fIVG\fP|\fILV\fP|\fITag\fP|\fISelect\fP ... @@ -320,7 +320,7 @@ required, after which the others are optional. .br .RS 4 .ad l -[ \fB-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -331,11 +331,11 @@ required, after which the others are optional. Resyncronize a mirror or raid LV. .br .P -\fBlvchange\fP \fB\-\-resync\fP \fIVG\fP|\fILV\fP\fI_mirror_raid\fP|\fITag\fP|\fISelect\fP ... +\fBlvchange\fP \fB--resync\fP \fIVG\fP|\fILV\fP\fI_mirror_raid\fP|\fITag\fP|\fISelect\fP ... .br .RS 4 .ad l -[ \fB-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -346,7 +346,7 @@ Resyncronize a mirror or raid LV. Resynchronize or check a raid LV. .br .P -\fBlvchange\fP \fB\-\-syncaction\fP \fBcheck\fP|\fBrepair\fP \fIVG\fP|\fILV\fP\fI_raid\fP|\fITag\fP|\fISelect\fP ... +\fBlvchange\fP \fB--syncaction\fP \fBcheck\fP|\fBrepair\fP \fIVG\fP|\fILV\fP\fI_raid\fP|\fITag\fP|\fISelect\fP ... .br .RS 4 [ COMMON_OPTIONS ] @@ -357,7 +357,7 @@ Resynchronize or check a raid LV. Reconstruct data on specific PVs of a raid LV. .br .P -\fBlvchange\fP \fB\-\-rebuild\fP \fIPV\fP \fIVG\fP|\fILV\fP\fI_raid\fP|\fITag\fP|\fISelect\fP ... +\fBlvchange\fP \fB--rebuild\fP \fIPV\fP \fIVG\fP|\fILV\fP\fI_raid\fP|\fITag\fP|\fISelect\fP ... .br .RS 4 [ COMMON_OPTIONS ] @@ -368,27 +368,27 @@ Reconstruct data on specific PVs of a raid LV. Activate or deactivate an LV. .br .P -\fBlvchange\fP \fB-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP \fIVG\fP|\fILV\fP|\fITag\fP|\fISelect\fP ... +\fBlvchange\fP \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP \fIVG\fP|\fILV\fP|\fITag\fP|\fISelect\fP ... .br .RS 4 .ad l -[ \fB-P\fP|\fB\-\-partial\fP ] +[ \fB-P\fP|\fB--partial\fP ] .ad b .br .ad l -[ \fB-K\fP|\fB\-\-ignoreactivationskip\fP ] +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] .ad b .br .ad l -[ \fB\-\-activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP ] +[ \fB--activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP ] .ad b .br .ad l -[ \fB\-\-ignorelockingfailure\fP ] +[ \fB--ignorelockingfailure\fP ] .ad b .br .ad l -[ \fB\-\-sysinit\fP ] +[ \fB--sysinit\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -399,15 +399,15 @@ Activate or deactivate an LV. Reactivate an LV using the latest metadata. .br .P -\fBlvchange\fP \fB\-\-refresh\fP \fIVG\fP|\fILV\fP|\fITag\fP|\fISelect\fP ... +\fBlvchange\fP \fB--refresh\fP \fIVG\fP|\fILV\fP|\fITag\fP|\fISelect\fP ... .br .RS 4 .ad l -[ \fB-P\fP|\fB\-\-partial\fP ] +[ \fB-P\fP|\fB--partial\fP ] .ad b .br .ad l -[ \fB\-\-poll\fP \fBy\fP|\fBn\fP ] +[ \fB--poll\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -418,11 +418,11 @@ Reactivate an LV using the latest metadata. Start or stop monitoring an LV from dmeventd. .br .P -\fBlvchange\fP \fB\-\-monitor\fP \fBy\fP|\fBn\fP \fIVG\fP|\fILV\fP|\fITag\fP|\fISelect\fP ... +\fBlvchange\fP \fB--monitor\fP \fBy\fP|\fBn\fP \fIVG\fP|\fILV\fP|\fITag\fP|\fISelect\fP ... .br .RS 4 .ad l -[ \fB\-\-poll\fP \fBy\fP|\fBn\fP ] +[ \fB--poll\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -433,11 +433,11 @@ Start or stop monitoring an LV from dmeventd. Start or stop processing an LV conversion. .br .P -\fBlvchange\fP \fB\-\-poll\fP \fBy\fP|\fBn\fP \fIVG\fP|\fILV\fP|\fITag\fP|\fISelect\fP ... +\fBlvchange\fP \fB--poll\fP \fBy\fP|\fBn\fP \fIVG\fP|\fILV\fP|\fITag\fP|\fISelect\fP ... .br .RS 4 .ad l -[ \fB\-\-monitor\fP \fBy\fP|\fBn\fP ] +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -448,11 +448,11 @@ Start or stop processing an LV conversion. Make the minor device number persistent for an LV. .br .P -\fBlvchange\fP \fB-M\fP|\fB\-\-persistent\fP \fBy\fP \fB\-\-minor\fP \fINumber\fP \fILV\fP +\fBlvchange\fP \fB-M\fP|\fB--persistent\fP \fBy\fP \fB--minor\fP \fINumber\fP \fILV\fP .br .RS 4 .ad l -[ \fB-j\fP|\fB\-\-major\fP \fINumber\fP ] +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -464,31 +464,31 @@ Common options for command: . .RS 4 .ad l -[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-f\fP|\fB\-\-force\fP ] +[ \fB-f\fP|\fB--force\fP ] .ad b .br .ad l -[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] +[ \fB-S\fP|\fB--select\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-ignoremonitoring\fP ] +[ \fB--ignoremonitoring\fP ] .ad b .br .ad l -[ \fB\-\-ignoreskippedcluster\fP ] +[ \fB--ignoreskippedcluster\fP ] .ad b .br .ad l -[ \fB\-\-noudevsync\fP ] +[ \fB--noudevsync\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .RE @@ -496,57 +496,57 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP +\fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP .br Change the active state of LVs. An active LV can be used through a block device, @@ -571,7 +571,7 @@ See clvmd(8) for more information about activation options \fBey\fP, \fBsy\fP, \ .ad b .HP .ad l -\fB\-\-activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP +\fB--activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP .br Determines if LV activation is allowed when PVs are missing, e.g. because of a device failure. @@ -586,14 +586,14 @@ See \fBlvmraid\fP(7) for more information. .ad b .HP .ad l -\fB\-\-addtag\fP \fITag\fP +\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 lvm(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 +\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 @@ -614,14 +614,14 @@ See \fBlvm\fP(8) for more information about allocation. .ad b .HP .ad l -\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP +\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 vgcfgbackup(8) for more information. .ad b .HP .ad l -\fB\-\-cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP +\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 @@ -637,14 +637,14 @@ block invalidates. See \fBlvmcache\fP(7) for more information. .ad b .HP .ad l -\fB\-\-cachepolicy\fP \fIString\fP +\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\-\-cachesettings\fP \fIString\fP +\fB--cachesettings\fP \fIString\fP .br Specifies tunable values for a cache LV in "Key = Value" form. Repeat this option to specify multiple values. @@ -656,14 +656,14 @@ See \fBlvmcache\fP(7) for more information. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -672,7 +672,7 @@ 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 +\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. @@ -682,28 +682,28 @@ are already contiguous. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-deltag\fP \fITag\fP +\fB--deltag\fP \fITag\fP .br Deletes a tag from a PV, VG or LV. This option can be repeated to delete multiple tags at once. See lvm(8) for information about tags. .ad b .HP .ad l -\fB\-\-detachprofile\fP +\fB--detachprofile\fP .br Detaches a metadata profile from a VG or LV. See \fBlvm.conf\fP(5) for more information about profiles. .ad b .HP .ad l -\fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP +\fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP .br Specifies how the device-mapper thin pool layer in the kernel should handle discards. @@ -716,14 +716,14 @@ See \fBlvmthin\fP(7) for more information. .ad b .HP .ad l -\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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 +\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 @@ -736,60 +736,60 @@ See \fBlvmthin\fP(7) for more information. .ad b .HP .ad l -\fB-f\fP|\fB\-\-force\fP ... +\fB-f\fP|\fB--force\fP ... .br Override various checks, confirmations and protections. Use with extreme caution. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB-K\fP|\fB\-\-ignoreactivationskip\fP +\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\-\-ignorelockingfailure\fP +\fB--ignorelockingfailure\fP .br Allows a command to continue with read-only metadata operations after locking failures. .ad b .HP .ad l -\fB\-\-ignoremonitoring\fP +\fB--ignoremonitoring\fP .br -Do not interact with dmeventd unless \-\-monitor is specified. +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\-\-ignoreskippedcluster\fP +\fB--ignoreskippedcluster\fP .br Use to avoid exiting with an non-zero status code if the command is run without clustered locking and clustered VGs are skipped. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB-j\fP|\fB\-\-major\fP \fINumber\fP +\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] +\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. @@ -798,20 +798,20 @@ See \fBlvmraid\fP(7) for more information. .ad b .HP .ad l -\fB\-\-metadataprofile\fP \fIString\fP +\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 +\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] +\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. @@ -820,7 +820,7 @@ See \fBlvmraid\fP(7) for more information. .ad b .HP .ad l -\fB\-\-monitor\fP \fBy\fP|\fBn\fP +\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 @@ -829,7 +829,7 @@ See dmeventd(8) for more information. .ad b .HP .ad l -\fB\-\-noudevsync\fP +\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 @@ -838,7 +838,7 @@ ignore the devices LVM creates. .ad b .HP .ad l -\fB-P\fP|\fB\-\-partial\fP +\fB-P\fP|\fB--partial\fP .br When set, the tools will do their best to provide access to VGs that are only partially available (one or more PVs belonging @@ -847,45 +847,45 @@ changed with this option. .ad b .HP .ad l -\fB-p\fP|\fB\-\-permission\fP \fBrw\fP|\fBr\fP +\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 +\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\-\-poll\fP \fBy\fP|\fBn\fP +\fB--poll\fP \fBy\fP|\fBn\fP .br When yes, start the background transformation of an LV. An incomplete transformation, e.g. pvmove or lvconvert interrupted -by reboot or crash, can be restarted from the last checkpoint with \-\-poll y. +by reboot or crash, can be restarted from the last checkpoint with --poll y. When no, background transformation of an LV will not occur, and the transformation will not complete. It may not be appropriate to immediately -poll an LV after activation, in which case \-\-poll n can be used to defer -polling until a later \-\-poll y command. +poll an LV after activation, in which case --poll n can be used to defer +polling until a later --poll y command. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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 +\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 @@ -894,18 +894,18 @@ a suitable value automatically. .ad b .HP .ad l -\fB\-\-rebuild\fP \fIPV\fP +\fB--rebuild\fP \fIPV\fP .br Selects a PV to rebuild in a raid LV. Multiple PVs can be rebuilt by repeating this option. -Use this option in place of \-\-resync or \-\-syncaction repair when the +Use this option in place of --resync or --syncaction repair when the PVs with corrupted data are known, and their data should be reconstructed rather than reconstructing default (rotating) data. See \fBlvmraid\fP(7) for more information. .ad b .HP .ad l -\fB\-\-refresh\fP +\fB--refresh\fP .br If the LV is active, reload its metadata. This is not necessary in normal operation, but may be useful @@ -914,7 +914,7 @@ sharing is being used. .ad b .HP .ad l -\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -925,11 +925,11 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB\-\-resync\fP +\fB--resync\fP .br Initiates mirror synchronization. Synchronization generally happens automatically, but this option forces it to run. -Also see \-\-rebuild to synchronize a specific PV. +Also see --rebuild to synchronize a specific PV. During synchronization, data is read from the primary mirror device and copied to the others. This can take considerable time, during which the LV is without a complete redundant copy of the data. @@ -937,12 +937,12 @@ See \fBlvmraid\fP(7) for more information. .ad b .HP .ad l -\fB-S\fP|\fB\-\-select\fP \fIString\fP +\fB-S\fP|\fB--select\fP \fIString\fP .br Select objects for processing and reporting based on specified criteria. -The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). +The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7). For reporting commands, one row is displayed for each object matching the criteria. -See \fB\-\-options help\fP for selectable object fields. +See \fB--options help\fP for selectable object fields. Rows can be displayed with an additional "selected" field (-o selected) showing 1 if the row matches the selection and 0 otherwise. For non-reporting commands which process LVM entities, the selection is @@ -950,18 +950,18 @@ used to choose items to process. .ad b .HP .ad l -\fB-k\fP|\fB\-\-setactivationskip\fP \fBy\fP|\fBn\fP +\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. +--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\-\-[raid]syncaction\fP \fBcheck\fP|\fBrepair\fP +\fB--[raid]syncaction\fP \fBcheck\fP|\fBrepair\fP .br Initiate different types of RAID synchronization. This causes the RAID LV to read all data and parity @@ -973,20 +973,20 @@ See lvs for reporting discrepancies found or repaired. .ad b .HP .ad l -\fB\-\-sysinit\fP +\fB--sysinit\fP .br Indicates that vgchange/lvchange is being invoked from early system initialisation scripts (e.g. rc.sysinit or an initrd), before writable filesystems are 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. +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 .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -996,20 +996,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB\-\-[raid]writebehind\fP \fINumber\fP +\fB--[raid]writebehind\fP \fINumber\fP .br The maximum number of outstanding writes that are allowed to devices in a RAID1 LV that is marked write-mostly. @@ -1020,7 +1020,7 @@ and allows the system to choose the value arbitrarily. .ad b .HP .ad l -\fB\-\-[raid]writemostly\fP \fIPV\fP[\fB:t\fP|\fBn\fP|\fBy\fP] +\fB--[raid]writemostly\fP \fIPV\fP[\fB:t\fP|\fBn\fP|\fBy\fP] .br Mark a device in a RAID1 LV as write-mostly. All reads to these drives will be avoided unless absolutely necessary. This keeps @@ -1033,7 +1033,7 @@ multiple PVs. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -1041,10 +1041,10 @@ answer yes. Use with extreme caution. .ad b .HP .ad l -\fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP +\fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP .br Set zeroing mode for thin pool. Note: already provisioned blocks from pool -in non-zero mode are not cleared in unwritten parts when setting \-\-zero y. +in non-zero mode are not cleared in unwritten parts when setting --zero y. .ad b .SH VARIABLES .HP @@ -1067,7 +1067,7 @@ in place of a VG, LV or PV. \fISelect\fP .br Select indicates that a required positional parameter can -be omitted if the \fB\-\-select\fP option is used. +be omitted if the \fB--select\fP option is used. No arg appears in this position. .HP \fIString\fP @@ -1084,7 +1084,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. @@ -1092,7 +1092,7 @@ For example, LVM_VG_NAME can generally be substituted for a required VG paramete .SH EXAMPLES Change LV permission to read-only: .sp -.B lvchange \-pr vg00/lvol1 +.B lvchange -pr vg00/lvol1 .SH SEE ALSO .BR lvm (8) diff --git a/man/lvconvert.8_pregen b/man/lvconvert.8_pregen index ba7beb479..e56b6deb7 100644 --- a/man/lvconvert.8_pregen +++ b/man/lvconvert.8_pregen @@ -1,6 +1,6 @@ .TH LVCONVERT 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -lvconvert \- Change logical volume layout +lvconvert - Change logical volume layout . .SH SYNOPSIS \fBlvconvert\fP \fIoption_args\fP \fIposition_args\fP @@ -11,227 +11,227 @@ lvconvert \- Change logical volume layout .br .P .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 .ad l - \fB-b\fP|\fB\-\-background\fP + \fB-b\fP|\fB--background\fP .ad b .br .ad l - \fB-H\fP|\fB\-\-cache\fP + \fB-H\fP|\fB--cache\fP .ad b .br .ad l - \fB\-\-cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP + \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP .ad b .br .ad l - \fB\-\-cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP + \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP .ad b .br .ad l - \fB\-\-cachepolicy\fP \fIString\fP + \fB--cachepolicy\fP \fIString\fP .ad b .br .ad l - \fB\-\-cachepool\fP \fILV\fP + \fB--cachepool\fP \fILV\fP .ad b .br .ad l - \fB\-\-cachesettings\fP \fIString\fP + \fB--cachesettings\fP \fIString\fP .ad b .br .ad l - \fB-c\fP|\fB\-\-chunksize\fP \fISize\fP[k|UNIT] + \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] .ad b .br .ad l - \fB\-\-commandprofile\fP \fIString\fP + \fB--commandprofile\fP \fIString\fP .ad b .br .ad l - \fB\-\-config\fP \fIString\fP + \fB--config\fP \fIString\fP .ad b .br .ad l - \fB-d\fP|\fB\-\-debug\fP + \fB-d\fP|\fB--debug\fP .ad b .br .ad l - \fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP + \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP .ad b .br .ad l - \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP + \fB--driverloaded\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB-f\fP|\fB\-\-force\fP + \fB-f\fP|\fB--force\fP .ad b .br .ad l - \fB-h\fP|\fB\-\-help\fP + \fB-h\fP|\fB--help\fP .ad b .br .ad l - \fB-i\fP|\fB\-\-interval\fP \fINumber\fP + \fB-i\fP|\fB--interval\fP \fINumber\fP .ad b .br .ad l - \fB\-\-longhelp\fP + \fB--longhelp\fP .ad b .br .ad l - \fB\-\-merge\fP + \fB--merge\fP .ad b .br .ad l - \fB\-\-mergemirrors\fP + \fB--mergemirrors\fP .ad b .br .ad l - \fB\-\-mergesnapshot\fP + \fB--mergesnapshot\fP .ad b .br .ad l - \fB\-\-mergethin\fP + \fB--mergethin\fP .ad b .br .ad l - \fB\-\-metadataprofile\fP \fIString\fP + \fB--metadataprofile\fP \fIString\fP .ad b .br .ad l - \fB\-\-mirrorlog\fP \fBcore\fP|\fBdisk\fP + \fB--mirrorlog\fP \fBcore\fP|\fBdisk\fP .ad b .br .ad l - \fB-m\fP|\fB\-\-mirrors\fP [\fB+\fP|\fB-\fP]\fINumber\fP + \fB-m\fP|\fB--mirrors\fP [\fB+\fP|\fB-\fP]\fINumber\fP .ad b .br .ad l - \fB-n\fP|\fB\-\-name\fP \fIString\fP + \fB-n\fP|\fB--name\fP \fIString\fP .ad b .br .ad l - \fB\-\-noudevsync\fP + \fB--noudevsync\fP .ad b .br .ad l - \fB\-\-originname\fP \fILV\fP + \fB--originname\fP \fILV\fP .ad b .br .ad l - \fB\-\-poolmetadata\fP \fILV\fP + \fB--poolmetadata\fP \fILV\fP .ad b .br .ad l - \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] + \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] .ad b .br .ad l - \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP + \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB\-\-profile\fP \fIString\fP + \fB--profile\fP \fIString\fP .ad b .br .ad l - \fB-q\fP|\fB\-\-quiet\fP + \fB-q\fP|\fB--quiet\fP .ad b .br .ad l - \fB-r\fP|\fB\-\-readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP + \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP .ad b .br .ad l - \fB-R\fP|\fB\-\-regionsize\fP \fISize\fP[m|UNIT] + \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] .ad b .br .ad l - \fB\-\-repair\fP + \fB--repair\fP .ad b .br .ad l - \fB\-\-replace\fP \fIPV\fP + \fB--replace\fP \fIPV\fP .ad b .br .ad l - \fB-s\fP|\fB\-\-snapshot\fP + \fB-s\fP|\fB--snapshot\fP .ad b .br .ad l - \fB\-\-splitcache\fP + \fB--splitcache\fP .ad b .br .ad l - \fB\-\-splitmirrors\fP \fINumber\fP + \fB--splitmirrors\fP \fINumber\fP .ad b .br .ad l - \fB\-\-splitsnapshot\fP + \fB--splitsnapshot\fP .ad b .br .ad l - \fB\-\-startpoll\fP + \fB--startpoll\fP .ad b .br .ad l - \fB\-\-stripes\fP \fINumber\fP + \fB--stripes\fP \fINumber\fP .ad b .br .ad l - \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] + \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] .ad b .br .ad l - \fB\-\-swapmetadata\fP + \fB--swapmetadata\fP .ad b .br .ad l - \fB-t\fP|\fB\-\-test\fP + \fB-t\fP|\fB--test\fP .ad b .br .ad l - \fB-T\fP|\fB\-\-thin\fP + \fB-T\fP|\fB--thin\fP .ad b .br .ad l - \fB\-\-thinpool\fP \fILV\fP + \fB--thinpool\fP \fILV\fP .ad b .br .ad l - \fB\-\-trackchanges\fP + \fB--trackchanges\fP .ad b .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--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\-\-uncache\fP + \fB--uncache\fP .ad b .br .ad l - \fB\-\-usepolicies\fP + \fB--usepolicies\fP .ad b .br .ad l - \fB-v\fP|\fB\-\-verbose\fP + \fB-v\fP|\fB--verbose\fP .ad b .br .ad l - \fB\-\-version\fP + \fB--version\fP .ad b .br .ad l - \fB-y\fP|\fB\-\-yes\fP + \fB-y\fP|\fB--yes\fP .ad b .br .ad l - \fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP + \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP .ad b .SH DESCRIPTION lvconvert changes the LV type and includes utilities for LV data @@ -240,7 +240,7 @@ The LV type is also called the segment type or segtype. To display the current LV type, run the command: -.B lvs \-o name,segtype +.B lvs -o name,segtype .I LV The @@ -302,7 +302,7 @@ Sub LVs can be displayed with the command Convert LV to linear. .br .P -\fBlvconvert\fP \fB\-\-type\fP \fBlinear\fP \fILV\fP +\fBlvconvert\fP \fB--type\fP \fBlinear\fP \fILV\fP .br .RS 4 [ COMMON_OPTIONS ] @@ -316,23 +316,23 @@ Convert LV to linear. Convert LV to striped. .br .P -\fBlvconvert\fP \fB\-\-type\fP \fBstriped\fP \fILV\fP +\fBlvconvert\fP \fB--type\fP \fBstriped\fP \fILV\fP .br .RS 4 .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \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] ] +[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB-i\fP|\fB\-\-interval\fP \fINumber\fP ] +[ \fB-i\fP|\fB--interval\fP \fINumber\fP ] .ad b .br .ad l -[ \fB\-\-stripes\fP \fINumber\fP ] +[ \fB--stripes\fP \fINumber\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -348,27 +348,27 @@ Convert LV to raid or change raid layout (a specific raid level must be used, e.g. raid1). .br .P -\fBlvconvert\fP \fB\-\-type\fP \fBraid\fP \fILV\fP +\fBlvconvert\fP \fB--type\fP \fBraid\fP \fILV\fP .br .RS 4 .ad l -[ \fB-m\fP|\fB\-\-mirrors\fP [\fB+\fP|\fB-\fP]\fINumber\fP ] +[ \fB-m\fP|\fB--mirrors\fP [\fB+\fP|\fB-\fP]\fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \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] ] +[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB-i\fP|\fB\-\-interval\fP \fINumber\fP ] +[ \fB-i\fP|\fB--interval\fP \fINumber\fP ] .ad b .br .ad l -[ \fB\-\-stripes\fP \fINumber\fP ] +[ \fB--stripes\fP \fINumber\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -382,19 +382,19 @@ Convert LV to raid or change raid layout Convert LV to raid1 or mirror, or change number of mirror images. .br .P -\fBlvconvert\fP \fB-m\fP|\fB\-\-mirrors\fP [\fB+\fP|\fB-\fP]\fINumber\fP \fILV\fP +\fBlvconvert\fP \fB-m\fP|\fB--mirrors\fP [\fB+\fP|\fB-\fP]\fINumber\fP \fILV\fP .br .RS 4 .ad l -[ \fB-R\fP|\fB\-\-regionsize\fP \fISize\fP[m|UNIT] ] +[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB-i\fP|\fB\-\-interval\fP \fINumber\fP ] +[ \fB-i\fP|\fB--interval\fP \fINumber\fP ] .ad b .br .ad l -[ \fB\-\-mirrorlog\fP \fBcore\fP|\fBdisk\fP ] +[ \fB--mirrorlog\fP \fBcore\fP|\fBdisk\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -408,19 +408,19 @@ Convert LV to raid1 or mirror, or change number of mirror images. Convert raid LV to change number of stripe images. .br .P -\fBlvconvert\fP \fB\-\-stripes\fP \fINumber\fP \fILV\fP\fI_raid\fP +\fBlvconvert\fP \fB--stripes\fP \fINumber\fP \fILV\fP\fI_raid\fP .br .RS 4 .ad l -[ \fB-i\fP|\fB\-\-interval\fP \fINumber\fP ] +[ \fB-i\fP|\fB--interval\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-R\fP|\fB\-\-regionsize\fP \fISize\fP[m|UNIT] ] +[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br [ COMMON_OPTIONS ] @@ -434,15 +434,15 @@ Convert raid LV to change number of stripe images. Convert raid LV to change the stripe size. .br .P -\fBlvconvert\fP \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] \fILV\fP\fI_raid\fP +\fBlvconvert\fP \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] \fILV\fP\fI_raid\fP .br .RS 4 .ad l -[ \fB-i\fP|\fB\-\-interval\fP \fINumber\fP ] +[ \fB-i\fP|\fB--interval\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-R\fP|\fB\-\-regionsize\fP \fISize\fP[m|UNIT] ] +[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ] .ad b .br [ COMMON_OPTIONS ] @@ -453,7 +453,7 @@ Convert raid LV to change the stripe size. Split images from a raid1 or mirror LV and use them to create a new LV. .br .P -\fBlvconvert\fP \fB\-\-splitmirrors\fP \fINumber\fP \fB-n\fP|\fB\-\-name\fP \fILV\fP\fI_new\fP \fILV\fP\fI_cache_mirror_raid1\fP +\fBlvconvert\fP \fB--splitmirrors\fP \fINumber\fP \fB-n\fP|\fB--name\fP \fILV\fP\fI_new\fP \fILV\fP\fI_cache_mirror_raid1\fP .br .RS 4 [ COMMON_OPTIONS ] @@ -467,7 +467,7 @@ Split images from a raid1 or mirror LV and use them to create a new LV. Split images from a raid1 LV and track changes to origin. .br .P -\fBlvconvert\fP \fB\-\-splitmirrors\fP \fINumber\fP \fB\-\-trackchanges\fP \fILV\fP\fI_cache_raid1\fP +\fBlvconvert\fP \fB--splitmirrors\fP \fINumber\fP \fB--trackchanges\fP \fILV\fP\fI_cache_raid1\fP .br .RS 4 [ COMMON_OPTIONS ] @@ -481,7 +481,7 @@ Split images from a raid1 LV and track changes to origin. Merge LV images that were split from a raid1 LV. .br .P -\fBlvconvert\fP \fB\-\-mergemirrors\fP \fIVG\fP|\fILV\fP\fI_linear_raid\fP|\fITag\fP ... +\fBlvconvert\fP \fB--mergemirrors\fP \fIVG\fP|\fILV\fP\fI_linear_raid\fP|\fITag\fP ... .br .RS 4 [ COMMON_OPTIONS ] @@ -492,43 +492,43 @@ Merge LV images that were split from a raid1 LV. Convert LV to a thin LV, using the original LV as an external origin. .br .P -\fBlvconvert\fP \fB\-\-type\fP \fBthin\fP \fB\-\-thinpool\fP \fILV\fP \fILV\fP\fI_linear_striped_cache_raid\fP +\fBlvconvert\fP \fB--type\fP \fBthin\fP \fB--thinpool\fP \fILV\fP \fILV\fP\fI_linear_striped_cache_raid\fP .br .RS 4 .ad l -[ \fB-T\fP|\fB\-\-thin\fP ] +[ \fB-T\fP|\fB--thin\fP ] .ad b .br .ad l -[ \fB-r\fP|\fB\-\-readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\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-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP ] +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-originname\fP \fILV\fP\fI_new\fP ] +[ \fB--originname\fP \fILV\fP\fI_new\fP ] .ad b .br .ad l -[ \fB\-\-poolmetadata\fP \fILV\fP ] +[ \fB--poolmetadata\fP \fILV\fP ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-metadataprofile\fP \fIString\fP ] +[ \fB--metadataprofile\fP \fIString\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -539,55 +539,55 @@ Convert LV to a thin LV, using the original LV as an external origin. Convert LV to type cache. .br .P -\fBlvconvert\fP \fB\-\-type\fP \fBcache\fP \fB\-\-cachepool\fP \fILV\fP \fILV\fP\fI_linear_striped_thinpool_raid\fP +\fBlvconvert\fP \fB--type\fP \fBcache\fP \fB--cachepool\fP \fILV\fP \fILV\fP\fI_linear_striped_thinpool_raid\fP .br .RS 4 .ad l -[ \fB-H\fP|\fB\-\-cache\fP ] +[ \fB-H\fP|\fB--cache\fP ] .ad b .br .ad l -[ \fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP ] +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-r\fP|\fB\-\-readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\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-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] +[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] .ad b .br .ad l -[ \fB\-\-cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] +[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] .ad b .br .ad l -[ \fB\-\-cachepolicy\fP \fIString\fP ] +[ \fB--cachepolicy\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-cachesettings\fP \fIString\fP ] +[ \fB--cachesettings\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-poolmetadata\fP \fILV\fP ] +[ \fB--poolmetadata\fP \fILV\fP ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-metadataprofile\fP \fIString\fP ] +[ \fB--metadataprofile\fP \fIString\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -598,47 +598,47 @@ Convert LV to type cache. Convert LV to type thin-pool. .br .P -\fBlvconvert\fP \fB\-\-type\fP \fBthin-pool\fP \fILV\fP\fI_linear_striped_cache_raid\fP +\fBlvconvert\fP \fB--type\fP \fBthin-pool\fP \fILV\fP\fI_linear_striped_cache_raid\fP .br .RS 4 .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB-r\fP|\fB\-\-readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\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-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP ] +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-stripes\fP \fINumber\fP ] +[ \fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] .ad b .br .ad l -[ \fB\-\-poolmetadata\fP \fILV\fP ] +[ \fB--poolmetadata\fP \fILV\fP ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-metadataprofile\fP \fIString\fP ] +[ \fB--metadataprofile\fP \fIString\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -652,51 +652,51 @@ Convert LV to type thin-pool. Convert LV to type cache-pool. .br .P -\fBlvconvert\fP \fB\-\-type\fP \fBcache-pool\fP \fILV\fP\fI_linear_striped_raid\fP +\fBlvconvert\fP \fB--type\fP \fBcache-pool\fP \fILV\fP\fI_linear_striped_raid\fP .br .RS 4 .ad l -[ \fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP ] +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-r\fP|\fB\-\-readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\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-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] +[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] .ad b .br .ad l -[ \fB\-\-cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] +[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] .ad b .br .ad l -[ \fB\-\-cachepolicy\fP \fIString\fP ] +[ \fB--cachepolicy\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-cachesettings\fP \fIString\fP ] +[ \fB--cachesettings\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-poolmetadata\fP \fILV\fP ] +[ \fB--poolmetadata\fP \fILV\fP ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-metadataprofile\fP \fIString\fP ] +[ \fB--metadataprofile\fP \fIString\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -710,7 +710,7 @@ Convert LV to type cache-pool. Separate and keep the cache pool from a cache LV. .br .P -\fBlvconvert\fP \fB\-\-splitcache\fP \fILV\fP\fI_thinpool_cache_cachepool\fP +\fBlvconvert\fP \fB--splitcache\fP \fILV\fP\fI_thinpool_cache_cachepool\fP .br .RS 4 [ COMMON_OPTIONS ] @@ -721,7 +721,7 @@ Separate and keep the cache pool from a cache LV. Merge thin LV into its origin LV. .br .P -\fBlvconvert\fP \fB\-\-mergethin\fP \fILV\fP\fI_thin\fP ... +\fBlvconvert\fP \fB--mergethin\fP \fILV\fP\fI_thin\fP ... .br .RS 4 [ COMMON_OPTIONS ] @@ -732,11 +732,11 @@ Merge thin LV into its origin LV. Merge COW snapshot LV into its origin. .br .P -\fBlvconvert\fP \fB\-\-mergesnapshot\fP \fILV\fP\fI_snapshot\fP ... +\fBlvconvert\fP \fB--mergesnapshot\fP \fILV\fP\fI_snapshot\fP ... .br .RS 4 .ad l -[ \fB-i\fP|\fB\-\-interval\fP \fINumber\fP ] +[ \fB-i\fP|\fB--interval\fP \fINumber\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -749,15 +749,15 @@ Replace failed PVs in a raid or mirror LV. Repair a thin pool. .br .P -\fBlvconvert\fP \fB\-\-repair\fP \fILV\fP\fI_thinpool_mirror_raid\fP +\fBlvconvert\fP \fB--repair\fP \fILV\fP\fI_thinpool_mirror_raid\fP .br .RS 4 .ad l -[ \fB-i\fP|\fB\-\-interval\fP \fINumber\fP ] +[ \fB-i\fP|\fB--interval\fP \fINumber\fP ] .ad b .br .ad l -[ \fB\-\-usepolicies\fP ] +[ \fB--usepolicies\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -771,7 +771,7 @@ Repair a thin pool. Replace specific PV(s) in a raid LV with another PV. .br .P -\fBlvconvert\fP \fB\-\-replace\fP \fIPV\fP \fILV\fP\fI_raid\fP +\fBlvconvert\fP \fB--replace\fP \fIPV\fP \fILV\fP\fI_raid\fP .br .RS 4 [ COMMON_OPTIONS ] @@ -785,7 +785,7 @@ Replace specific PV(s) in a raid LV with another PV. Poll LV to continue conversion. .br .P -\fBlvconvert\fP \fB\-\-startpoll\fP \fILV\fP\fI_mirror_raid\fP +\fBlvconvert\fP \fB--startpoll\fP \fILV\fP\fI_mirror_raid\fP .br .RS 4 [ COMMON_OPTIONS ] @@ -797,19 +797,19 @@ Common options for command: . .RS 4 .ad l -[ \fB-b\fP|\fB\-\-background\fP ] +[ \fB-b\fP|\fB--background\fP ] .ad b .br .ad l -[ \fB-f\fP|\fB\-\-force\fP ] +[ \fB-f\fP|\fB--force\fP ] .ad b .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 .ad l -[ \fB\-\-noudevsync\fP ] +[ \fB--noudevsync\fP ] .ad b .RE @@ -817,57 +817,57 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .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 .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 @@ -888,7 +888,7 @@ See \fBlvm\fP(8) for more information about allocation. .ad b .HP .ad l -\fB-b\fP|\fB\-\-background\fP +\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 @@ -896,21 +896,21 @@ background. .ad b .HP .ad l -\fB-H\fP|\fB\-\-cache\fP +\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 --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 +\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 +\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 @@ -926,20 +926,20 @@ block invalidates. See \fBlvmcache\fP(7) for more information. .ad b .HP .ad l -\fB\-\-cachepolicy\fP \fIString\fP +\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 +\fB--cachepool\fP \fILV\fP .br The name of a cache pool LV. .ad b .HP .ad l -\fB\-\-cachesettings\fP \fIString\fP +\fB--cachesettings\fP \fIString\fP .br Specifies tunable values for a cache LV in "Key = Value" form. Repeat this option to specify multiple values. @@ -951,7 +951,7 @@ See \fBlvmcache\fP(7) for more information. .ad b .HP .ad l -\fB-c\fP|\fB\-\-chunksize\fP \fISize\fP[k|UNIT] +\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 @@ -966,14 +966,14 @@ See \fBlvmthin\fP(7) and \fBlvmcache\fP(7) for more information. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -982,14 +982,14 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP +\fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP .br Specifies how the device-mapper thin pool layer in the kernel should handle discards. @@ -1002,53 +1002,53 @@ See \fBlvmthin\fP(7) for more information. .ad b .HP .ad l -\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-f\fP|\fB\-\-force\fP ... +\fB-f\fP|\fB--force\fP ... .br Override various checks, confirmations and protections. Use with extreme caution. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB-i\fP|\fB\-\-interval\fP \fINumber\fP +\fB-i\fP|\fB--interval\fP \fINumber\fP .br Report progress at regular intervals. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-merge\fP +\fB--merge\fP .br -An alias for \-\-mergethin, \-\-mergemirrors, or \-\-mergesnapshot, +An alias for --mergethin, --mergemirrors, or --mergesnapshot, depending on the type of LV. .ad b .HP .ad l -\fB\-\-mergemirrors\fP +\fB--mergemirrors\fP .br Merge LV images that were split from a raid1 LV. -See \-\-splitmirrors with \-\-trackchanges. +See --splitmirrors with --trackchanges. .ad b .HP .ad l -\fB\-\-mergesnapshot\fP +\fB--mergesnapshot\fP .br Merge COW snapshot LV into its origin. When merging a snapshot, if both the origin and snapshot LVs are not open, @@ -1065,7 +1065,7 @@ used to specify multiple snapshots be merged to their respective origin. .ad b .HP .ad l -\fB\-\-mergethin\fP +\fB--mergethin\fP .br Merge thin LV into its origin LV. The origin thin LV takes the content of the thin snapshot, @@ -1074,14 +1074,14 @@ See \fBlvmthin\fP(7) for more information. .ad b .HP .ad l -\fB\-\-metadataprofile\fP \fIString\fP +\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\-\-mirrorlog\fP \fBcore\fP|\fBdisk\fP +\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.) @@ -1090,20 +1090,21 @@ 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. +\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 [\fB+\fP|\fB-\fP]\fINumber\fP +\fB-m\fP|\fB--mirrors\fP [\fB+\fP|\fB-\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 +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, +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. @@ -1115,7 +1116,7 @@ See \fBlvmraid\fP(7) for more information. .ad b .HP .ad l -\fB-n\fP|\fB\-\-name\fP \fIString\fP +\fB-n\fP|\fB--name\fP \fIString\fP .br Specifies the name of a new LV. When unspecified, a default name of "lvol#" is @@ -1123,7 +1124,7 @@ generated, where # is a number generated by LVM. .ad b .HP .ad l -\fB\-\-noudevsync\fP +\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 @@ -1132,7 +1133,7 @@ ignore the devices LVM creates. .ad b .HP .ad l -\fB\-\-originname\fP \fILV\fP +\fB--originname\fP \fILV\fP .br Specifies the name to use for the external origin LV when converting an LV to a thin LV. The LV being converted becomes a read-only external origin @@ -1140,19 +1141,19 @@ with this name. .ad b .HP .ad l -\fB\-\-poolmetadata\fP \fILV\fP +\fB--poolmetadata\fP \fILV\fP .br The name of a an LV to use for storing pool metadata. .ad b .HP .ad l -\fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] +\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 +\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 @@ -1160,21 +1161,21 @@ space that can be used when repairing a pool. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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 +\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 @@ -1183,7 +1184,7 @@ a suitable value automatically. .ad b .HP .ad l -\fB-R\fP|\fB\-\-regionsize\fP \fISize\fP[m|UNIT] +\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 @@ -1191,7 +1192,7 @@ configure a default. .ad b .HP .ad l -\fB\-\-repair\fP +\fB--repair\fP .br Replace failed PVs in a raid or mirror LV, or run a repair utility on a thin pool. See \fBlvmraid\fP(7) and \fBlvmthin\fP(7) @@ -1199,7 +1200,7 @@ for more information. .ad b .HP .ad l -\fB\-\-replace\fP \fIPV\fP +\fB--replace\fP \fIPV\fP .br Replace a specific PV in a raid LV with another PV. The new PV to use can be optionally specified after the LV. @@ -1208,29 +1209,29 @@ See \fBlvmraid\fP(7) for more information. .ad b .HP .ad l -\fB-s\fP|\fB\-\-snapshot\fP +\fB-s\fP|\fB--snapshot\fP .br Combine a former COW snapshot LV with a former origin LV to reverse -a previous \-\-splitsnapshot command. +a previous --splitsnapshot command. .ad b .HP .ad l -\fB\-\-splitcache\fP +\fB--splitcache\fP .br Separates a cache pool from a cache LV, and keeps the unused cache pool LV. -Before the separation, the cache is flushed. Also see \-\-uncache. +Before the separation, the cache is flushed. Also see --uncache. .ad b .HP .ad l -\fB\-\-splitmirrors\fP \fINumber\fP +\fB--splitmirrors\fP \fINumber\fP .br 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, +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. .ad b .HP .ad l -\fB\-\-splitsnapshot\fP +\fB--splitsnapshot\fP .br Separates a COW snapshot from its origin LV. The LV that is split off contains the chunks that differ from the origin LV along with metadata @@ -1238,30 +1239,30 @@ describing them. This LV can be wiped and then destroyed with lvremove. .ad b .HP .ad l -\fB\-\-startpoll\fP +\fB--startpoll\fP .br Start polling an LV to continue processing a conversion. .ad b .HP .ad l -\fB\-\-stripes\fP \fINumber\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 apply to +the stripe size (see --stripesize). This does not apply to existing allocated space, only newly allocated space can be striped. .ad b .HP .ad l -\fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] +\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\-\-swapmetadata\fP +\fB--swapmetadata\fP .br Extracts the metadata LV from a pool and replaces it with another specified LV. The extracted LV is preserved and given the name of the LV that replaced it. @@ -1272,7 +1273,7 @@ be activated directly and used with thin provisioning tools: .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -1282,23 +1283,23 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-T\fP|\fB\-\-thin\fP +\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 --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 +\fB--thinpool\fP \fILV\fP .br The name of a thin pool LV. .ad b .HP .ad l -\fB\-\-trackchanges\fP +\fB--trackchanges\fP .br -Can be used with \-\-splitmirrors on a raid1 LV. This causes +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 @@ -1307,7 +1308,7 @@ when using the raid1 LV type.) .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 +\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. @@ -1317,39 +1318,39 @@ 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). +(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\-\-uncache\fP +\fB--uncache\fP .br Separates a cache pool from a cache LV, and deletes the unused cache pool LV. -Before the separation, the cache is flushed. Also see \-\-splitcache. +Before the separation, the cache is flushed. Also see --splitcache. .ad b .HP .ad l -\fB\-\-usepolicies\fP +\fB--usepolicies\fP .br Perform an operation according to the policy configured in lvm.conf or a profile. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -1357,7 +1358,7 @@ answer yes. Use with extreme caution. .ad b .HP .ad l -\fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP +\fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP .br For snapshots, this controls zeroing of the first 4KiB of data in the snapshot. If the LV is read-only, the snapshot will not be zeroed. @@ -1406,7 +1407,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. @@ -1419,23 +1420,23 @@ Convert LV to type mirror (also see type raid1), (also see lvconvert \-\-mirrors). .br .P -\fBlvconvert\fP \fB\-\-type\fP \fBmirror\fP \fILV\fP +\fBlvconvert\fP \fB--type\fP \fBmirror\fP \fILV\fP .br .RS 4 .ad l -[ \fB-m\fP|\fB\-\-mirrors\fP [\fB+\fP|\fB-\fP]\fINumber\fP ] +[ \fB-m\fP|\fB--mirrors\fP [\fB+\fP|\fB-\fP]\fINumber\fP ] .ad b .br .ad l -[ \fB-R\fP|\fB\-\-regionsize\fP \fISize\fP[m|UNIT] ] +[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB-i\fP|\fB\-\-interval\fP \fINumber\fP ] +[ \fB-i\fP|\fB--interval\fP \fINumber\fP ] .ad b .br .ad l -[ \fB\-\-mirrorlog\fP \fBcore\fP|\fBdisk\fP ] +[ \fB--mirrorlog\fP \fBcore\fP|\fBdisk\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -1449,7 +1450,7 @@ Convert LV to type mirror (also see type raid1), Change the region size of an LV. .br .P -\fBlvconvert\fP \fB-R\fP|\fB\-\-regionsize\fP \fISize\fP[m|UNIT] \fILV\fP\fI_raid\fP +\fBlvconvert\fP \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] \fILV\fP\fI_raid\fP .br .RS 4 [ COMMON_OPTIONS ] @@ -1460,7 +1461,7 @@ Change the region size of an LV. Change the type of mirror log used by a mirror LV. .br .P -\fBlvconvert\fP \fB\-\-mirrorlog\fP \fBcore\fP|\fBdisk\fP \fILV\fP\fI_mirror\fP +\fBlvconvert\fP \fB--mirrorlog\fP \fBcore\fP|\fBdisk\fP \fILV\fP\fI_mirror\fP .br .RS 4 [ COMMON_OPTIONS ] @@ -1476,43 +1477,43 @@ Convert LV to a thin LV, using the original LV as an external origin (infers \-\-type thin). .br .P -\fBlvconvert\fP \fB-T\fP|\fB\-\-thin\fP \fB\-\-thinpool\fP \fILV\fP \fILV\fP\fI_linear_striped_cache_raid\fP +\fBlvconvert\fP \fB-T\fP|\fB--thin\fP \fB--thinpool\fP \fILV\fP \fILV\fP\fI_linear_striped_cache_raid\fP .br .RS 4 .ad l -[ \fB-r\fP|\fB\-\-readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\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-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP ] +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-type\fP \fBthin\fP ] +[ \fB--type\fP \fBthin\fP ] .ad b .br .ad l -[ \fB\-\-originname\fP \fILV\fP\fI_new\fP ] +[ \fB--originname\fP \fILV\fP\fI_new\fP ] .ad b .br .ad l -[ \fB\-\-poolmetadata\fP \fILV\fP ] +[ \fB--poolmetadata\fP \fILV\fP ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-metadataprofile\fP \fIString\fP ] +[ \fB--metadataprofile\fP \fIString\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -1523,55 +1524,55 @@ Convert LV to a thin LV, using the original LV as an external origin Convert LV to type cache (infers \-\-type cache). .br .P -\fBlvconvert\fP \fB-H\fP|\fB\-\-cache\fP \fB\-\-cachepool\fP \fILV\fP \fILV\fP\fI_linear_striped_thinpool_raid\fP +\fBlvconvert\fP \fB-H\fP|\fB--cache\fP \fB--cachepool\fP \fILV\fP \fILV\fP\fI_linear_striped_thinpool_raid\fP .br .RS 4 .ad l -[ \fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP ] +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-r\fP|\fB\-\-readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\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-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-type\fP \fBcache\fP ] +[ \fB--type\fP \fBcache\fP ] .ad b .br .ad l -[ \fB\-\-cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] +[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] .ad b .br .ad l -[ \fB\-\-cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] +[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] .ad b .br .ad l -[ \fB\-\-cachepolicy\fP \fIString\fP ] +[ \fB--cachepolicy\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-cachesettings\fP \fIString\fP ] +[ \fB--cachesettings\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-poolmetadata\fP \fILV\fP ] +[ \fB--poolmetadata\fP \fILV\fP ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-metadataprofile\fP \fIString\fP ] +[ \fB--metadataprofile\fP \fIString\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -1582,7 +1583,7 @@ Convert LV to type cache (infers \-\-type cache). Separate and delete the cache pool from a cache LV. .br .P -\fBlvconvert\fP \fB\-\-uncache\fP \fILV\fP\fI_thinpool_cache\fP +\fBlvconvert\fP \fB--uncache\fP \fILV\fP\fI_thinpool_cache\fP .br .RS 4 [ COMMON_OPTIONS ] @@ -1593,11 +1594,11 @@ Separate and delete the cache pool from a cache LV. Swap metadata LV in a thin pool or cache pool (for repair only). .br .P -\fBlvconvert\fP \fB\-\-swapmetadata\fP \fB\-\-poolmetadata\fP \fILV\fP \fILV\fP\fI_thinpool_cachepool\fP +\fBlvconvert\fP \fB--swapmetadata\fP \fB--poolmetadata\fP \fILV\fP \fILV\fP\fI_thinpool_cachepool\fP .br .RS 4 .ad l -[ \fB-c\fP|\fB\-\-chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br [ COMMON_OPTIONS ] @@ -1612,11 +1613,11 @@ Merge thin LV into its origin LV (variant, use \-\-mergethin). Merge COW snapshot LV into its origin (variant, use \-\-mergesnapshot). .br .P -\fBlvconvert\fP \fB\-\-merge\fP \fIVG\fP|\fILV\fP\fI_linear_striped_snapshot_thin_raid\fP|\fITag\fP ... +\fBlvconvert\fP \fB--merge\fP \fIVG\fP|\fILV\fP\fI_linear_striped_snapshot_thin_raid\fP|\fITag\fP ... .br .RS 4 .ad l -[ \fB-i\fP|\fB\-\-interval\fP \fINumber\fP ] +[ \fB-i\fP|\fB--interval\fP \fINumber\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -1627,7 +1628,7 @@ Merge COW snapshot LV into its origin (variant, use \-\-mergesnapshot). Separate a COW snapshot from its origin LV. .br .P -\fBlvconvert\fP \fB\-\-splitsnapshot\fP \fILV\fP\fI_snapshot\fP +\fBlvconvert\fP \fB--splitsnapshot\fP \fILV\fP\fI_snapshot\fP .br .RS 4 [ COMMON_OPTIONS ] @@ -1640,19 +1641,19 @@ Combine a former COW snapshot (second arg) with a former origin LV (first arg) to reverse a splitsnapshot command. .br .P -\fBlvconvert\fP \fB\-\-type\fP \fBsnapshot\fP \fILV\fP \fILV\fP\fI_linear\fP +\fBlvconvert\fP \fB--type\fP \fBsnapshot\fP \fILV\fP \fILV\fP\fI_linear\fP .br .RS 4 .ad l -[ \fB-s\fP|\fB\-\-snapshot\fP ] +[ \fB-s\fP|\fB--snapshot\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB\-\-chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP ] +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -1665,19 +1666,19 @@ Combine a former COW snapshot (second arg) with a former origin LV (first arg) to reverse a splitsnapshot command. .br .P -\fBlvconvert\fP \fB-s\fP|\fB\-\-snapshot\fP \fILV\fP \fILV\fP\fI_linear\fP +\fBlvconvert\fP \fB-s\fP|\fB--snapshot\fP \fILV\fP \fILV\fP\fI_linear\fP .br .RS 4 .ad l -[ \fB-c\fP|\fB\-\-chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP ] +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-type\fP \fBsnapshot\fP ] +[ \fB--type\fP \fBsnapshot\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -1699,7 +1700,7 @@ Poll LV to continue conversion (also see \-\-startpoll). .SH NOTES This previous command syntax would perform two different operations: .br -\fBlvconvert \-\-thinpool\fP \fILV1\fP \fB\-\-poolmetadata\fP \fILV2\fP +\fBlvconvert --thinpool\fP \fILV1\fP \fB--poolmetadata\fP \fILV2\fP .br If LV1 was not a thin pool, the command would convert LV1 to a thin pool, optionally using a specified LV for metadata. @@ -1709,7 +1710,7 @@ the current metadata LV with LV2 (for repair purposes.) In the same way, this previous command syntax would perform two different operations: .br -\fBlvconvert \-\-cachepool\fP \fILV1\fP \fB\-\-poolmetadata\fP \fILV2\fP +\fBlvconvert --cachepool\fP \fILV1\fP \fB--poolmetadata\fP \fILV2\fP .br If LV1 was not a cache pool, the command would convert LV1 to a cache pool, optionally using a specified LV for metadata. @@ -1718,96 +1719,96 @@ the current metadata LV with LV2 (for repair purposes.) .SH EXAMPLES Convert a linear LV to a two-way mirror LV. .br -.B lvconvert \-\-type mirror \-\-mirrors 1 vg/lvol1 +.B lvconvert --type mirror --mirrors 1 vg/lvol1 Convert a linear LV to a two-way RAID1 LV. .br -.B lvconvert \-\-type raid1 \-\-mirrors 1 vg/lvol1 +.B lvconvert --type raid1 --mirrors 1 vg/lvol1 -Convert a mirror LV to use an in\-memory log. +Convert a mirror LV to use an in-memory log. .br -.B lvconvert \-\-mirrorlog core vg/lvol1 +.B lvconvert --mirrorlog core vg/lvol1 Convert a mirror LV to use a disk log. .br -.B lvconvert \-\-mirrorlog disk vg/lvol1 +.B lvconvert --mirrorlog disk vg/lvol1 Convert a mirror or raid1 LV to a linear LV. .br -.B lvconvert \-\-type linear vg/lvol1 +.B lvconvert --type linear vg/lvol1 Convert a mirror LV to a raid1 LV with the same number of images. .br -.B lvconvert \-\-type raid1 vg/lvol1 +.B lvconvert --type raid1 vg/lvol1 Convert a linear LV to a two-way mirror LV, allocating new extents from specific PV ranges. .br -.B lvconvert \-\-mirrors 1 vg/lvol1 /dev/sda:0\-15 /dev/sdb:0\-15 +.B lvconvert --mirrors 1 vg/lvol1 /dev/sda:0-15 /dev/sdb:0-15 Convert a mirror LV to a linear LV, freeing physical extents from a specific PV. .br -.B lvconvert \-\-type linear vg/lvol1 /dev/sda +.B lvconvert --type linear vg/lvol1 /dev/sda Split one image from a mirror or raid1 LV, making it a new LV. .br -.B lvconvert \-\-splitmirrors 1 \-\-name lv_split vg/lvol1 +.B lvconvert --splitmirrors 1 --name lv_split vg/lvol1 Split one image from a raid1 LV, and track changes made to the raid1 LV while the split image remains detached. .br -.B lvconvert \-\-splitmirrors 1 \-\-trackchanges vg/lvol1 +.B lvconvert --splitmirrors 1 --trackchanges vg/lvol1 -Merge an image (that was previously created with \-\-splitmirrors and -\-\-trackchanges) back into the original raid1 LV. +Merge an image (that was previously created with --splitmirrors and +--trackchanges) back into the original raid1 LV. .br -.B lvconvert \-\-mergemirrors vg/lvol1_rimage_1 +.B lvconvert --mergemirrors vg/lvol1_rimage_1 Replace PV /dev/sdb1 with PV /dev/sdf1 in a raid1/4/5/6/10 LV. .br -.B lvconvert \-\-replace /dev/sdb1 vg/lvol1 /dev/sdf1 +.B lvconvert --replace /dev/sdb1 vg/lvol1 /dev/sdf1 Replace 3 PVs /dev/sd[b-d]1 with PVs /dev/sd[f-h]1 in a raid1 LV. .br -.B lvconvert \-\-replace /dev/sdb1 \-\-replace /dev/sdc1 \-\-replace /dev/sdd1 +.B lvconvert --replace /dev/sdb1 --replace /dev/sdc1 --replace /dev/sdd1 .RS .B vg/lvol1 /dev/sd[fgh]1 .RE Replace the maximum of 2 PVs /dev/sd[bc]1 with PVs /dev/sd[gh]1 in a raid6 LV. .br -.B lvconvert \-\-replace /dev/sdb1 \-\-replace /dev/sdc1 vg/lvol1 /dev/sd[gh]1 +.B lvconvert --replace /dev/sdb1 --replace /dev/sdc1 vg/lvol1 /dev/sd[gh]1 Convert an LV into a thin LV in the specified thin pool. The existing LV -is used as an external read\-only origin for the new thin LV. +is used as an external read-only origin for the new thin LV. .br -.B lvconvert \-\-type thin \-\-thinpool vg/tpool1 vg/lvol1 +.B lvconvert --type thin --thinpool vg/tpool1 vg/lvol1 Convert an LV into a thin LV in the specified thin pool. The existing LV -is used as an external read\-only origin for the new thin LV, and is +is used as an external read-only origin for the new thin LV, and is renamed "external". .br -.B lvconvert \-\-type thin \-\-thinpool vg/tpool1 +.B lvconvert --type thin --thinpool vg/tpool1 .RS -.B \-\-originname external vg/lvol1 +.B --originname external vg/lvol1 .RE Convert an LV to a cache pool LV using another specified LV for cache pool metadata. .br -.B lvconvert \-\-type cache-pool \-\-poolmetadata vg/poolmeta1 vg/lvol1 +.B lvconvert --type cache-pool --poolmetadata vg/poolmeta1 vg/lvol1 Convert an LV to a cache LV using the specified cache pool and chunk size. .br -.B lvconvert \-\-type cache \-\-cachepool vg/cpool1 \-c 128 vg/lvol1 +.B lvconvert --type cache --cachepool vg/cpool1 -c 128 vg/lvol1 Detach and keep the cache pool from a cache LV. .br -.B lvconvert \-\-splitcache vg/lvol1 +.B lvconvert --splitcache vg/lvol1 Detach and remove the cache pool from a cache LV. .br -.B lvconvert \-\-uncache vg/lvol1 +.B lvconvert --uncache vg/lvol1 .SH SEE ALSO .BR lvm (8) diff --git a/man/lvcreate.8_pregen b/man/lvcreate.8_pregen index cf8bfeb4e..6663087da 100644 --- a/man/lvcreate.8_pregen +++ b/man/lvcreate.8_pregen @@ -1,6 +1,6 @@ .TH LVCREATE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -lvcreate \- Create a logical volume +lvcreate - Create a logical volume . .SH SYNOPSIS \fBlvcreate\fP \fIoption_args\fP \fIposition_args\fP @@ -11,235 +11,235 @@ lvcreate \- Create a logical volume .br .P .ad l - \fB-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP + \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP .ad b .br .ad l - \fB\-\-addtag\fP \fITag\fP + \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 + \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP .ad b .br .ad l - \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP + \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB-H\fP|\fB\-\-cache\fP + \fB-H\fP|\fB--cache\fP .ad b .br .ad l - \fB\-\-cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP + \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP .ad b .br .ad l - \fB\-\-cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP + \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP .ad b .br .ad l - \fB\-\-cachepolicy\fP \fIString\fP + \fB--cachepolicy\fP \fIString\fP .ad b .br .ad l - \fB\-\-cachepool\fP \fILV\fP + \fB--cachepool\fP \fILV\fP .ad b .br .ad l - \fB\-\-cachesettings\fP \fIString\fP + \fB--cachesettings\fP \fIString\fP .ad b .br .ad l - \fB-c\fP|\fB\-\-chunksize\fP \fISize\fP[k|UNIT] + \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] .ad b .br .ad l - \fB\-\-commandprofile\fP \fIString\fP + \fB--commandprofile\fP \fIString\fP .ad b .br .ad l - \fB\-\-config\fP \fIString\fP + \fB--config\fP \fIString\fP .ad b .br .ad l - \fB-C\fP|\fB\-\-contiguous\fP \fBy\fP|\fBn\fP + \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB-d\fP|\fB\-\-debug\fP + \fB-d\fP|\fB--debug\fP .ad b .br .ad l - \fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP + \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP .ad b .br .ad l - \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP + \fB--driverloaded\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB\-\-errorwhenfull\fP \fBy\fP|\fBn\fP + \fB--errorwhenfull\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB-l\fP|\fB\-\-extents\fP \fINumber\fP[PERCENT] + \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] .ad b .br .ad l - \fB-h\fP|\fB\-\-help\fP + \fB-h\fP|\fB--help\fP .ad b .br .ad l - \fB-K\fP|\fB\-\-ignoreactivationskip\fP + \fB-K\fP|\fB--ignoreactivationskip\fP .ad b .br .ad l - \fB\-\-ignoremonitoring\fP + \fB--ignoremonitoring\fP .ad b .br .ad l - \fB\-\-longhelp\fP + \fB--longhelp\fP .ad b .br .ad l - \fB-j\fP|\fB\-\-major\fP \fINumber\fP + \fB-j\fP|\fB--major\fP \fINumber\fP .ad b .br .ad l - \fB\-\-[raid]maxrecoveryrate\fP \fISize\fP[k|UNIT] + \fB--[raid]maxrecoveryrate\fP \fISize\fP[k|UNIT] .ad b .br .ad l - \fB\-\-metadataprofile\fP \fIString\fP + \fB--metadataprofile\fP \fIString\fP .ad b .br .ad l - \fB\-\-minor\fP \fINumber\fP + \fB--minor\fP \fINumber\fP .ad b .br .ad l - \fB\-\-[raid]minrecoveryrate\fP \fISize\fP[k|UNIT] + \fB--[raid]minrecoveryrate\fP \fISize\fP[k|UNIT] .ad b .br .ad l - \fB\-\-mirrorlog\fP \fBcore\fP|\fBdisk\fP + \fB--mirrorlog\fP \fBcore\fP|\fBdisk\fP .ad b .br .ad l - \fB-m\fP|\fB\-\-mirrors\fP \fINumber\fP + \fB-m\fP|\fB--mirrors\fP \fINumber\fP .ad b .br .ad l - \fB\-\-monitor\fP \fBy\fP|\fBn\fP + \fB--monitor\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB-n\fP|\fB\-\-name\fP \fIString\fP + \fB-n\fP|\fB--name\fP \fIString\fP .ad b .br .ad l - \fB\-\-nosync\fP + \fB--nosync\fP .ad b .br .ad l - \fB\-\-noudevsync\fP + \fB--noudevsync\fP .ad b .br .ad l - \fB-p\fP|\fB\-\-permission\fP \fBrw\fP|\fBr\fP + \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 + \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] + \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] .ad b .br .ad l - \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP + \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB\-\-profile\fP \fIString\fP + \fB--profile\fP \fIString\fP .ad b .br .ad l - \fB-q\fP|\fB\-\-quiet\fP + \fB-q\fP|\fB--quiet\fP .ad b .br .ad l - \fB-r\fP|\fB\-\-readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP + \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP .ad b .br .ad l - \fB-R\fP|\fB\-\-regionsize\fP \fISize\fP[m|UNIT] + \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] .ad b .br .ad l - \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP + \fB--reportformat\fP \fBbasic\fP|\fBjson\fP .ad b .br .ad l - \fB-k\fP|\fB\-\-setactivationskip\fP \fBy\fP|\fBn\fP + \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB-L\fP|\fB\-\-size\fP \fISize\fP[m|UNIT] + \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] .ad b .br .ad l - \fB-s\fP|\fB\-\-snapshot\fP + \fB-s\fP|\fB--snapshot\fP .ad b .br .ad l - \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP + \fB-i\fP|\fB--stripes\fP \fINumber\fP .ad b .br .ad l - \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] + \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] .ad b .br .ad l - \fB-t\fP|\fB\-\-test\fP + \fB-t\fP|\fB--test\fP .ad b .br .ad l - \fB-T\fP|\fB\-\-thin\fP + \fB-T\fP|\fB--thin\fP .ad b .br .ad l - \fB\-\-thinpool\fP \fILV\fP + \fB--thinpool\fP \fILV\fP .ad b .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--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-v\fP|\fB\-\-verbose\fP + \fB-v\fP|\fB--verbose\fP .ad b .br .ad l - \fB\-\-version\fP + \fB--version\fP .ad b .br .ad l - \fB-V\fP|\fB\-\-virtualsize\fP \fISize\fP[m|UNIT] + \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] .ad b .br .ad l - \fB-W\fP|\fB\-\-wipesignatures\fP \fBy\fP|\fBn\fP + \fB-W\fP|\fB--wipesignatures\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB-y\fP|\fB\-\-yes\fP + \fB-y\fP|\fB--yes\fP .ad b .br .ad l - \fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP + \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP .ad b .SH DESCRIPTION lvcreate creates a new LV in a VG. For standard LVs, this requires @@ -270,11 +270,11 @@ virtual size rather than a physical size. A cache LV is the combination of a standard LV with a cache pool, used to cache active portions of the LV to improve performance. .SS Usage notes -In the usage section below, \fB\-\-size\fP \fISize\fP can be replaced -with \fB\-\-extents\fP \fINumber\fP. See both descriptions +In the usage section below, \fB--size\fP \fISize\fP can be replaced +with \fB--extents\fP \fINumber\fP. See both descriptions the options section. -In the usage section below, \fB\-\-name\fP is omitted from the required +In the usage section below, \fB--name\fP is omitted from the required options, even though it is typically used. When the name is not specified, a new LV name is generated with the "lvol" prefix and a unique numeric suffix. Also see the description in the options section. @@ -282,15 +282,15 @@ numeric suffix. Also see the description in the options section. Create a linear LV. .br .P -\fBlvcreate\fP \fB-L\fP|\fB\-\-size\fP \fISize\fP[m|UNIT] \fIVG\fP +\fBlvcreate\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-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB\-\-type\fP \fBlinear\fP ] +[ \fB--type\fP \fBlinear\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -304,15 +304,15 @@ Create a linear LV. 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 +\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-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br [ COMMON_OPTIONS ] @@ -326,27 +326,27 @@ Create a striped LV (infers \-\-type striped). 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 +\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-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-R\fP|\fB\-\-regionsize\fP \fISize\fP[m|UNIT] ] +[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-mirrorlog\fP \fBcore\fP|\fBdisk\fP ] +[ \fB--mirrorlog\fP \fBcore\fP|\fBdisk\fP ] .ad b .br .ad l -[ \fB\-\-[raid]minrecoveryrate\fP \fISize\fP[k|UNIT] ] +[ \fB--[raid]minrecoveryrate\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-[raid]maxrecoveryrate\fP \fISize\fP[k|UNIT] ] +[ \fB--[raid]maxrecoveryrate\fP \fISize\fP[k|UNIT] ] .ad b .br [ COMMON_OPTIONS ] @@ -360,35 +360,35 @@ Create a raid1 or mirror LV (infers \-\-type raid1|mirror). 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 +\fBlvcreate\fP \fB--type\fP \fBraid\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP .br .RS 4 .ad l -[ \fB-l\fP|\fB\-\-extents\fP \fINumber\fP[PERCENT] ] +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-m\fP|\fB\-\-mirrors\fP \fINumber\fP ] +[ \fB-m\fP|\fB--mirrors\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP ] +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \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] ] +[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-[raid]minrecoveryrate\fP \fISize\fP[k|UNIT] ] +[ \fB--[raid]minrecoveryrate\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-[raid]maxrecoveryrate\fP \fISize\fP[k|UNIT] ] +[ \fB--[raid]maxrecoveryrate\fP \fISize\fP[k|UNIT] ] .ad b .br [ COMMON_OPTIONS ] @@ -402,30 +402,30 @@ Create a raid LV (a specific raid level must be used, e.g. raid1). Create a raid10 LV. .br .P -\fBlvcreate\fP \fB-m\fP|\fB\-\-mirrors\fP \fINumber\fP \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP +\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 + \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP .RE .br .RS 4 .ad l -[ \fB-l\fP|\fB\-\-extents\fP \fINumber\fP[PERCENT] ] +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \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] ] +[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-[raid]minrecoveryrate\fP \fISize\fP[k|UNIT] ] +[ \fB--[raid]minrecoveryrate\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-[raid]maxrecoveryrate\fP \fISize\fP[k|UNIT] ] +[ \fB--[raid]maxrecoveryrate\fP \fISize\fP[k|UNIT] ] .ad b .br [ COMMON_OPTIONS ] @@ -439,27 +439,27 @@ Create a raid10 LV. 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 +\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] ] +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP ] +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \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] ] +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-type\fP \fBsnapshot\fP ] +[ \fB--type\fP \fBsnapshot\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -473,43 +473,43 @@ Create a COW snapshot LV of an origin LV. 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 +\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-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-c\fP|\fB\-\-chunksize\fP \fISize\fP[k|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-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-thinpool\fP \fILV\fP\fI_new\fP ] +[ \fB--thinpool\fP \fILV\fP\fI_new\fP ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] .ad b .br .ad l -[ \fB\-\-errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -523,43 +523,43 @@ Create a thin pool. 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 +\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-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-H\fP|\fB\-\-cache\fP ] +[ \fB-H\fP|\fB--cache\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB\-\-chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] +[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] .ad b .br .ad l -[ \fB\-\-cachepolicy\fP \fIString\fP ] +[ \fB--cachepolicy\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-cachesettings\fP \fIString\fP ] +[ \fB--cachesettings\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] +[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -573,23 +573,23 @@ Create a cache pool. 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 +\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 ] +[ \fB-T\fP|\fB--thin\fP ] .ad b .br .ad l -[ \fB\-\-type\fP \fBthin\fP ] +[ \fB--type\fP \fBthin\fP ] .ad b .br .ad l -[ \fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] .ad b .br .ad l -[ \fB\-\-errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -602,19 +602,19 @@ Create a thin LV that is a snapshot of an existing thin LV (infers \-\-type thin). .br .P -\fBlvcreate\fP \fB-s\fP|\fB\-\-snapshot\fP \fILV\fP\fI_thin\fP +\fBlvcreate\fP \fB-s\fP|\fB--snapshot\fP \fILV\fP\fI_thin\fP .br .RS 4 .ad l -[ \fB\-\-type\fP \fBthin\fP ] +[ \fB--type\fP \fBthin\fP ] .ad b .br .ad l -[ \fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] .ad b .br .ad l -[ \fB\-\-errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -625,31 +625,31 @@ Create a thin LV that is a snapshot of an existing thin LV 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 +\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 ] +[ \fB-T\fP|\fB--thin\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB\-\-chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] .ad b .br .ad l -[ \fB\-\-errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -662,46 +662,46 @@ Create a thin LV, first creating a thin pool for it, 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] +\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 + \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] ] +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-T\fP|\fB\-\-thin\fP ] +[ \fB-T\fP|\fB--thin\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB\-\-chunksize\fP \fISize\fP[k|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-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] .ad b .br .ad l -[ \fB\-\-errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -719,54 +719,54 @@ then combining it with the existing cache pool named by the \-\-cachepool arg. .br .P -\fBlvcreate\fP \fB\-\-type\fP \fBcache\fP \fB-L\fP|\fB\-\-size\fP \fISize\fP[m|UNIT] +\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 + \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] ] +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-H\fP|\fB\-\-cache\fP ] +[ \fB-H\fP|\fB--cache\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB\-\-chunksize\fP \fISize\fP[k|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-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] +[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] .ad b .br .ad l -[ \fB\-\-cachepolicy\fP \fIString\fP ] +[ \fB--cachepolicy\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-cachesettings\fP \fIString\fP ] +[ \fB--cachesettings\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] +[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -781,87 +781,87 @@ Common options for command: . .RS 4 .ad l -[ \fB-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] .ad b .br .ad l -[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-C\fP|\fB\-\-contiguous\fP \fBy\fP|\fBn\fP ] +[ \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-K\fP|\fB\-\-ignoreactivationskip\fP ] +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] .ad b .br .ad l -[ \fB-j\fP|\fB\-\-major\fP \fINumber\fP ] +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-n\fP|\fB\-\-name\fP \fIString\fP ] +[ \fB-n\fP|\fB--name\fP \fIString\fP ] .ad b .br .ad l -[ \fB-p\fP|\fB\-\-permission\fP \fBrw\fP|\fBr\fP ] +[ \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 ] +[ \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 ] +[ \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 ] +[ \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 ] +[ \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 ] +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-addtag\fP \fITag\fP ] +[ \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 ] +[ \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 ] +[ \fB--ignoremonitoring\fP ] .ad b .br .ad l -[ \fB\-\-metadataprofile\fP \fIString\fP ] +[ \fB--metadataprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-minor\fP \fINumber\fP ] +[ \fB--minor\fP \fINumber\fP ] .ad b .br .ad l -[ \fB\-\-monitor\fP \fBy\fP|\fBn\fP ] +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-nosync\fP ] +[ \fB--nosync\fP ] .ad b .br .ad l -[ \fB\-\-noudevsync\fP ] +[ \fB--noudevsync\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .RE @@ -869,57 +869,57 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP +\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. @@ -927,24 +927,24 @@ 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. +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. +\fBay\fP implies --zero n and --wipesignatures n. See lvmlockd(8) for more information about activation options for shared VGs. See clvmd(8) for more information about activation options for clustered VGs. .ad b .HP .ad l -\fB\-\-addtag\fP \fITag\fP +\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 lvm(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 +\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 @@ -965,28 +965,28 @@ See \fBlvm\fP(8) for more information about allocation. .ad b .HP .ad l -\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP +\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 vgcfgbackup(8) for more information. .ad b .HP .ad l -\fB-H\fP|\fB\-\-cache\fP +\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 --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 +\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 +\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 @@ -1002,20 +1002,20 @@ block invalidates. See \fBlvmcache\fP(7) for more information. .ad b .HP .ad l -\fB\-\-cachepolicy\fP \fIString\fP +\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 +\fB--cachepool\fP \fILV\fP .br The name of a cache pool LV. .ad b .HP .ad l -\fB\-\-cachesettings\fP \fIString\fP +\fB--cachesettings\fP \fIString\fP .br Specifies tunable values for a cache LV in "Key = Value" form. Repeat this option to specify multiple values. @@ -1027,7 +1027,7 @@ See \fBlvmcache\fP(7) for more information. .ad b .HP .ad l -\fB-c\fP|\fB\-\-chunksize\fP \fISize\fP[k|UNIT] +\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 @@ -1042,14 +1042,14 @@ See \fBlvmthin\fP(7) and \fBlvmcache\fP(7) for more information. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -1058,7 +1058,7 @@ 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 +\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. @@ -1068,14 +1068,14 @@ are already contiguous. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP +\fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP .br Specifies how the device-mapper thin pool layer in the kernel should handle discards. @@ -1088,14 +1088,14 @@ See \fBlvmthin\fP(7) for more information. .ad b .HP .ad l -\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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 +\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 @@ -1108,10 +1108,10 @@ See \fBlvmthin\fP(7) for more information. .ad b .HP .ad l -\fB-l\fP|\fB\-\-extents\fP \fINumber\fP[PERCENT] +\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 --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 @@ -1128,39 +1128,39 @@ extents in the new LV is not determined until the command has completed. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB-K\fP|\fB\-\-ignoreactivationskip\fP +\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 +\fB--ignoremonitoring\fP .br -Do not interact with dmeventd unless \-\-monitor is specified. +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\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB-j\fP|\fB\-\-major\fP \fINumber\fP +\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] +\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. @@ -1169,20 +1169,20 @@ See \fBlvmraid\fP(7) for more information. .ad b .HP .ad l -\fB\-\-metadataprofile\fP \fIString\fP +\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 +\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] +\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. @@ -1191,7 +1191,7 @@ See \fBlvmraid\fP(7) for more information. .ad b .HP .ad l -\fB\-\-mirrorlog\fP \fBcore\fP|\fBdisk\fP +\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.) @@ -1200,29 +1200,30 @@ 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. +\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 +\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 +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, +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 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 +\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 @@ -1231,7 +1232,7 @@ See dmeventd(8) for more information. .ad b .HP .ad l -\fB-n\fP|\fB\-\-name\fP \fIString\fP +\fB-n\fP|\fB--name\fP \fIString\fP .br Specifies the name of a new LV. When unspecified, a default name of "lvol#" is @@ -1239,7 +1240,7 @@ generated, where # is a number generated by LVM. .ad b .HP .ad l -\fB\-\-nosync\fP +\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 @@ -1256,7 +1257,7 @@ and thus do not support initial synchronization. .ad b .HP .ad l -\fB\-\-noudevsync\fP +\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 @@ -1265,25 +1266,25 @@ ignore the devices LVM creates. .ad b .HP .ad l -\fB-p\fP|\fB\-\-permission\fP \fBrw\fP|\fBr\fP +\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 +\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] +\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 +\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 @@ -1291,21 +1292,21 @@ space that can be used when repairing a pool. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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 +\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 @@ -1314,7 +1315,7 @@ a suitable value automatically. .ad b .HP .ad l -\fB-R\fP|\fB\-\-regionsize\fP \fISize\fP[m|UNIT] +\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 @@ -1322,7 +1323,7 @@ configure a default. .ad b .HP .ad l -\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -1333,27 +1334,27 @@ 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 +\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. +--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] +\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 --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 +\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 @@ -1364,7 +1365,7 @@ 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. +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 @@ -1378,36 +1379,36 @@ 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 +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 +\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 +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: 4, raid4/5: 3, raid6: 5.) +(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] +\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 +\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 @@ -1417,21 +1418,21 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-T\fP|\fB\-\-thin\fP +\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 --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 +\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 +\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. @@ -1441,25 +1442,25 @@ 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). +(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-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-V\fP|\fB\-\-virtualsize\fP \fISize\fP[m|UNIT] +\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. @@ -1476,13 +1477,13 @@ large sparse LVs (GiB). .ad b .HP .ad l -\fB-W\fP|\fB\-\-wipesignatures\fP \fBy\fP|\fBn\fP +\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.) +(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 +(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) @@ -1494,7 +1495,7 @@ The LV is not wiped if the read only flag is set. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -1502,7 +1503,7 @@ answer yes. Use with extreme caution. .ad b .HP .ad l -\fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP +\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. @@ -1517,7 +1518,7 @@ Warning: trying to mount an unzeroed LV can cause the system to hang. 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. +e.g. --name VG/LV. .HP \fILV\fP .br @@ -1550,7 +1551,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. @@ -1561,11 +1562,11 @@ Alternate command forms, advanced command usage, and listing of all valid syntax 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 +\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] ] +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br [ COMMON_OPTIONS ] @@ -1576,11 +1577,11 @@ Create an LV that returns errors when used. 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 +\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] ] +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br [ COMMON_OPTIONS ] @@ -1591,11 +1592,11 @@ Create an LV that returns zeros when read. 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 +\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] ] +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br [ COMMON_OPTIONS ] @@ -1609,19 +1610,19 @@ Create a linear LV. 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 +\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] ] +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP ] +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br [ COMMON_OPTIONS ] @@ -1635,31 +1636,31 @@ Create a striped LV (also see lvcreate \-\-stripes). 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 +\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] ] +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-m\fP|\fB\-\-mirrors\fP \fINumber\fP ] +[ \fB-m\fP|\fB--mirrors\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-R\fP|\fB\-\-regionsize\fP \fISize\fP[m|UNIT] ] +[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP ] +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-mirrorlog\fP \fBcore\fP|\fBdisk\fP ] +[ \fB--mirrorlog\fP \fBcore\fP|\fBdisk\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -1675,27 +1676,27 @@ Create a COW snapshot LV of an origin LV (also see \-\-snapshot). .br .P -\fBlvcreate\fP \fB\-\-type\fP \fBsnapshot\fP \fB-L\fP|\fB\-\-size\fP \fISize\fP[m|UNIT] \fILV\fP +\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] ] +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-s\fP|\fB\-\-snapshot\fP ] +[ \fB-s\fP|\fB--snapshot\fP ] .ad b .br .ad l -[ \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP ] +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \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] ] +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br [ COMMON_OPTIONS ] @@ -1711,22 +1712,22 @@ Create a sparse COW snapshot LV of a virtual origin LV (also see \-\-snapshot). .br .P -\fBlvcreate\fP \fB\-\-type\fP \fBsnapshot\fP \fB-L\fP|\fB\-\-size\fP \fISize\fP[m|UNIT] +\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 + \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] ] +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-s\fP|\fB\-\-snapshot\fP ] +[ \fB-s\fP|\fB--snapshot\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB\-\-chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br [ COMMON_OPTIONS ] @@ -1740,22 +1741,22 @@ Create a sparse COW snapshot LV of a virtual origin LV 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] +\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 + \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] ] +[ \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-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-type\fP \fBsnapshot\fP ] +[ \fB--type\fP \fBsnapshot\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -1769,43 +1770,43 @@ Create a sparse COW snapshot LV of a virtual origin LV. 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 +\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] ] +[ \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-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP ] +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-type\fP \fBthin-pool\fP ] +[ \fB--type\fP \fBthin-pool\fP ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] .ad b .br .ad l -[ \fB\-\-errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -1821,47 +1822,47 @@ Create a thin pool named by the \-\-thinpool arg (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 +\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] ] +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-T\fP|\fB\-\-thin\fP ] +[ \fB-T\fP|\fB--thin\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB\-\-chunksize\fP \fISize\fP[k|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-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-type\fP \fBthin-pool\fP ] +[ \fB--type\fP \fBthin-pool\fP ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] .ad b .br .ad l -[ \fB\-\-errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -1877,46 +1878,46 @@ Create a cache pool named by the \-\-cachepool arg (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] +\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 + \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-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-H\fP|\fB\-\-cache\fP ] +[ \fB-H\fP|\fB--cache\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB\-\-chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] +[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] .ad b .br .ad l -[ \fB\-\-cachepolicy\fP \fIString\fP ] +[ \fB--cachepolicy\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-cachesettings\fP \fIString\fP ] +[ \fB--cachesettings\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] +[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -1930,34 +1931,34 @@ Create a cache pool named by the \-\-cachepool arg 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] +\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 + \fB--thinpool\fP \fILV\fP\fI_thinpool\fP \fIVG\fP .RE .br .RS 4 .ad l -[ \fB-T\fP|\fB\-\-thin\fP ] +[ \fB-T\fP|\fB--thin\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB\-\-chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] .ad b .br .ad l -[ \fB\-\-errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -1970,19 +1971,19 @@ Create a thin LV in a thin pool named in the first arg (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 +\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 ] +[ \fB-T\fP|\fB--thin\fP ] .ad b .br .ad l -[ \fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] .ad b .br .ad l -[ \fB\-\-errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -1997,23 +1998,23 @@ Create a thin LV in the thin pool named in the first arg naming pool.) .br .P -\fBlvcreate\fP \fB-V\fP|\fB\-\-virtualsize\fP \fISize\fP[m|UNIT] \fILV\fP\fI_thinpool\fP +\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 ] +[ \fB-T\fP|\fB--thin\fP ] .ad b .br .ad l -[ \fB\-\-type\fP \fBthin\fP ] +[ \fB--type\fP \fBthin\fP ] .ad b .br .ad l -[ \fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] .ad b .br .ad l -[ \fB\-\-errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -2024,19 +2025,19 @@ naming pool.) 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 +\fBlvcreate\fP \fB--type\fP \fBthin\fP \fILV\fP\fI_thin\fP .br .RS 4 .ad l -[ \fB-T\fP|\fB\-\-thin\fP ] +[ \fB-T\fP|\fB--thin\fP ] .ad b .br .ad l -[ \fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] .ad b .br .ad l -[ \fB\-\-errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -2049,19 +2050,19 @@ Create a thin LV that is a snapshot of an existing thin LV (infers \-\-type thin). .br .P -\fBlvcreate\fP \fB-T\fP|\fB\-\-thin\fP \fILV\fP\fI_thin\fP +\fBlvcreate\fP \fB-T\fP|\fB--thin\fP \fILV\fP\fI_thin\fP .br .RS 4 .ad l -[ \fB\-\-type\fP \fBthin\fP ] +[ \fB--type\fP \fBthin\fP ] .ad b .br .ad l -[ \fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] .ad b .br .ad l -[ \fB\-\-errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -2074,19 +2075,19 @@ Create a thin LV that is a snapshot of an external origin LV (infers \-\-type thin). .br .P -\fBlvcreate\fP \fB-s\fP|\fB\-\-snapshot\fP \fB\-\-thinpool\fP \fILV\fP\fI_thinpool\fP \fILV\fP +\fBlvcreate\fP \fB-s\fP|\fB--snapshot\fP \fB--thinpool\fP \fILV\fP\fI_thinpool\fP \fILV\fP .br .RS 4 .ad l -[ \fB\-\-type\fP \fBthin\fP ] +[ \fB--type\fP \fBthin\fP ] .ad b .br .ad l -[ \fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] .ad b .br .ad l -[ \fB\-\-errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -2101,46 +2102,103 @@ where the new thin pool is named by the \-\-thinpool arg (variant, infers \-\-type thin). .br .P -\fBlvcreate\fP \fB-T\fP|\fB\-\-thin\fP \fB-V\fP|\fB\-\-virtualsize\fP \fISize\fP[m|UNIT] +\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-L\fP|\fB\-\-size\fP \fISize\fP[m|UNIT] \fB\-\-thinpool\fP \fILV\fP\fI_new\fP + \fB--thinpool\fP \fILV\fP\fI_new\fP .RE .br .RS 4 .ad l -[ \fB-l\fP|\fB\-\-extents\fP \fINumber\fP[PERCENT] ] +[ \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-T\fP|\fB--thin\fP ] .ad b .br .ad l -[ \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP ] +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .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\fP ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] .ad b .br .ad l -[ \fB\-\-errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\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-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 [ COMMON_OPTIONS ] @@ -2160,46 +2218,46 @@ or the new thin pool name is generated when the first arg is a VG name. .br .P -\fBlvcreate\fP \fB\-\-type\fP \fBthin\fP \fB-V\fP|\fB\-\-virtualsize\fP \fISize\fP[m|UNIT] +\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 + \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP|\fILV\fP\fI_new\fP .RE .br .RS 4 .ad l -[ \fB-l\fP|\fB\-\-extents\fP \fINumber\fP[PERCENT] ] +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-T\fP|\fB\-\-thin\fP ] +[ \fB-T\fP|\fB--thin\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB\-\-chunksize\fP \fISize\fP[k|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-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP ] .ad b .br .ad l -[ \fB\-\-errorwhenfull\fP \fBy\fP|\fBn\fP ] +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -2219,46 +2277,42 @@ or the new thin pool name is generated when the first arg is a VG name (variant, infers \-\-type thin). .br .P -\fBlvcreate\fP \fB-T\fP|\fB\-\-thin\fP \fB-V\fP|\fB\-\-virtualsize\fP \fISize\fP[m|UNIT] +\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 + \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP|\fILV\fP\fI_new\fP .RE .br .RS 4 .ad l -[ \fB-l\fP|\fB\-\-extents\fP \fINumber\fP[PERCENT] ] +[ \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-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP ] +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-type\fP \fBthin\fP ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\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 ] +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -2282,51 +2336,47 @@ Chooses \-\-type thin or \-\-type snapshot according to 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 +\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-l\fP|\fB\-\-extents\fP \fINumber\fP[PERCENT] ] +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-T\fP|\fB\-\-thin\fP ] +[ \fB-s\fP|\fB--snapshot\fP ] .ad b .br .ad l -[ \fB-s\fP|\fB\-\-snapshot\fP ] +[ \fB-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB-c\fP|\fB\-\-chunksize\fP \fISize\fP[k|UNIT] ] +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB--type\fP \fBsnapshot\fP ] .ad b .br .ad l -[ \fB\-\-type\fP \fBthin\fP ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\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 ] +[ \fB--errorwhenfull\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -2344,47 +2394,47 @@ then combining it with the existing cache pool named by the \-\-cachepool arg (variant, infers \-\-type cache). .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-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-l\fP|\fB\-\-extents\fP \fINumber\fP[PERCENT] ] +[ \fB-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-H\fP|\fB\-\-cache\fP ] +[ \fB-H\fP|\fB--cache\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB\-\-chunksize\fP \fISize\fP[k|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-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-type\fP \fBcache\fP ] +[ \fB--type\fP \fBcache\fP ] .ad b .br .ad l -[ \fB\-\-cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] +[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] .ad b .br .ad l -[ \fB\-\-cachepolicy\fP \fIString\fP ] +[ \fB--cachepolicy\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-cachesettings\fP \fIString\fP ] +[ \fB--cachesettings\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] +[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -2402,51 +2452,51 @@ then combining it with the existing cache pool named 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 +\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-l\fP|\fB--extents\fP \fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-H\fP|\fB\-\-cache\fP ] +[ \fB-H\fP|\fB--cache\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB\-\-chunksize\fP \fISize\fP[k|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-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] +[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] .ad b .br .ad l -[ \fB\-\-cachepolicy\fP \fIString\fP ] +[ \fB--cachepolicy\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-cachesettings\fP \fIString\fP ] +[ \fB--cachesettings\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] +[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -2472,47 +2522,47 @@ to type cache after creating a new cache pool LV to use (use lvconvert). .br .P -\fBlvcreate\fP \fB-H\fP|\fB\-\-cache\fP \fB-L\fP|\fB\-\-size\fP \fISize\fP[m|UNIT] \fILV\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 -[ \fB-l\fP|\fB\-\-extents\fP \fINumber\fP[PERCENT] ] +[ \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-c\fP|\fB--chunksize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP ] +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] +[ \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP ] .ad b .br .ad l -[ \fB\-\-cachepolicy\fP \fIString\fP ] +[ \fB--cachepolicy\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-cachesettings\fP \fIString\fP ] +[ \fB--cachesettings\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] +[ \fB--cachemetadataformat\fP \fBauto\fP|\fB1\fP|\fB2\fP ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--poolmetadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadataspare\fP \fBy\fP|\fBn\fP ] +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -2528,56 +2578,56 @@ to type cache after creating a new cache pool LV to use Create a striped LV with 3 stripes, a stripe size of 8KiB and a size of 100MiB. The LV name is chosen by lvcreate. .br -.B lvcreate \-i 3 \-I 8 \-L 100m vg00 +.B lvcreate -i 3 -I 8 -L 100m vg00 Create a raid1 LV with two images, and a useable size of 500 MiB. This operation requires two devices, one for each mirror image. RAID metadata (superblock and bitmap) is also included on the two devices. .br -.B lvcreate \-\-type raid1 \-m1 \-L 500m \-n mylv vg00 +.B lvcreate --type raid1 -m1 -L 500m -n mylv vg00 Create a mirror LV with two images, and a useable size of 500 MiB. This operation requires three devices: two for mirror images and one for a disk log. .br -.B lvcreate \-\-type mirror \-m1 \-L 500m \-n mylv vg00 +.B lvcreate --type mirror -m1 -L 500m -n mylv vg00 Create a mirror LV with 2 images, and a useable size of 500 MiB. This operation requires 2 devices because the log is in memory. .br -.B lvcreate \-\-type mirror \-m1 \-\-mirrorlog core \-L 500m \-n mylv vg00 +.B lvcreate --type mirror -m1 --mirrorlog core -L 500m -n mylv vg00 -Create a copy\-on\-write snapshot of an LV: +Create a copy-on-write snapshot of an LV: .br -.B lvcreate \-\-snapshot \-\-size 100m \-\-name mysnap vg00/mylv +.B lvcreate --snapshot --size 100m --name mysnap vg00/mylv -Create a copy\-on\-write snapshot with a size sufficient +Create a copy-on-write snapshot with a size sufficient for overwriting 20% of the size of the original LV. .br -.B lvcreate \-s \-l 20%ORIGIN \-n mysnap vg00/mylv +.B lvcreate -s -l 20%ORIGIN -n mysnap vg00/mylv Create a sparse LV with 1TiB of virtual space, and actual space just under 100MiB. .br -.B lvcreate \-\-snapshot \-\-virtualsize 1t \-\-size 100m \-\-name mylv vg00 +.B lvcreate --snapshot --virtualsize 1t --size 100m --name mylv vg00 Create a linear LV with a usable size of 64MiB on specific physical extents. .br -.B lvcreate \-L 64m \-n mylv vg00 /dev/sda:0\-7 /dev/sdb:0\-7 +.B lvcreate -L 64m -n mylv vg00 /dev/sda:0-7 /dev/sdb:0-7 Create a RAID5 LV with a usable size of 5GiB, 3 stripes, a stripe size of 64KiB, using a total of 4 devices (including one for parity). .br -.B lvcreate \-\-type raid5 \-L 5G \-i 3 \-I 64 \-n mylv vg00 +.B lvcreate --type raid5 -L 5G -i 3 -I 64 -n mylv vg00 Create a RAID5 LV using all of the free space in the VG and spanning all the PVs in the VG (note that the command will fail if there are more than 8 PVs in -the VG, in which case \fB\-i 7\fP must be used to get to the current maximum of +the VG, in which case \fB-i 7\fP must be used to get to the current maximum of 8 devices including parity for RaidLVs). .br -.B lvcreate \-\-config allocation/raid_stripe_all_devices=1 +.B lvcreate --config allocation/raid_stripe_all_devices=1 .RS -.B \-\-type raid5 \-l 100%FREE \-n mylv vg00 +.B --type raid5 -l 100%FREE -n mylv vg00 .RE Create RAID10 LV with a usable size of 5GiB, using 2 stripes, each on @@ -2587,38 +2637,38 @@ differently: but \fB-m\fP specifies the number of images in addition to the first image). .br -.B lvcreate \-\-type raid10 \-L 5G \-i 2 \-m 1 \-n mylv vg00 +.B lvcreate --type raid10 -L 5G -i 2 -m 1 -n mylv vg00 Create a 1TiB thin LV, first creating a new thin pool for it, where the thin pool has 100MiB of space, uses 2 stripes, has a 64KiB stripe size, and 256KiB chunk size. .br -.B lvcreate \-\-type thin \-\-name mylv \-\-thinpool mypool +.B lvcreate --type thin --name mylv --thinpool mypool .RS -.B \-V 1t \-L 100m \-i 2 \-I 64 \-c 256 vg00 +.B -V 1t -L 100m -i 2 -I 64 -c 256 vg00 .RE Create a thin snapshot of a thin LV (the size option must not be used, otherwise a copy-on-write snapshot would be created). .br -.B lvcreate \-\-snapshot \-\-name mysnap vg00/thinvol +.B lvcreate --snapshot --name mysnap vg00/thinvol Create a thin snapshot of the read-only inactive LV named "origin" which becomes an external origin for the thin snapshot LV. .br -.B lvcreate \-\-snapshot \-\-name mysnap \-\-thinpool mypool vg00/origin +.B lvcreate --snapshot --name mysnap --thinpool mypool vg00/origin Create a cache pool from a fast physical device. The cache pool can then be used to cache an LV. .br -.B lvcreate \-\-type cache-pool \-L 1G \-n my_cpool vg00 /dev/fast1 +.B lvcreate --type cache-pool -L 1G -n my_cpool vg00 /dev/fast1 Create a cache LV, first creating a new origin LV on a slow physical device, then combining the new origin LV with an existing cache pool. .br -.B lvcreate \-\-type cache \-\-cachepool my_cpool +.B lvcreate --type cache --cachepool my_cpool .RS -.B \-L 100G \-n mylv vg00 /dev/slow1 +.B -L 100G -n mylv vg00 /dev/slow1 .RE .SH SEE ALSO diff --git a/man/lvdisplay.8_pregen b/man/lvdisplay.8_pregen index 5aeb86161..25ce5b851 100644 --- a/man/lvdisplay.8_pregen +++ b/man/lvdisplay.8_pregen @@ -1,6 +1,6 @@ .TH LVDISPLAY 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -lvdisplay \- Display information about a logical volume +lvdisplay - Display information about a logical volume . .SH SYNOPSIS \fBlvdisplay\fP @@ -20,103 +20,103 @@ and more, using a more compact and configurable output format. .br .RS 4 .ad l -[ \fB-a\fP|\fB\-\-all\fP ] +[ \fB-a\fP|\fB--all\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB\-\-colon\fP ] +[ \fB-c\fP|\fB--colon\fP ] .ad b .br .ad l -[ \fB-C\fP|\fB\-\-columns\fP ] +[ \fB-C\fP|\fB--columns\fP ] .ad b .br .ad l -[ \fB-H\fP|\fB\-\-history\fP ] +[ \fB-H\fP|\fB--history\fP ] .ad b .br .ad l -[ \fB-m\fP|\fB\-\-maps\fP ] +[ \fB-m\fP|\fB--maps\fP ] .ad b .br .ad l -[ \fB-o\fP|\fB\-\-options\fP \fIString\fP ] +[ \fB-o\fP|\fB--options\fP \fIString\fP ] .ad b .br .ad l -[ \fB-O\fP|\fB\-\-sort\fP \fIString\fP ] +[ \fB-O\fP|\fB--sort\fP \fIString\fP ] .ad b .br .ad l -[ \fB-P\fP|\fB\-\-partial\fP ] +[ \fB-P\fP|\fB--partial\fP ] .ad b .br .ad l -[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] +[ \fB-S\fP|\fB--select\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-aligned\fP ] +[ \fB--aligned\fP ] .ad b .br .ad l -[ \fB\-\-binary\fP ] +[ \fB--binary\fP ] .ad b .br .ad l -[ \fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ] +[ \fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ] .ad b .br .ad l -[ \fB\-\-foreign\fP ] +[ \fB--foreign\fP ] .ad b .br .ad l -[ \fB\-\-ignorelockingfailure\fP ] +[ \fB--ignorelockingfailure\fP ] .ad b .br .ad l -[ \fB\-\-ignoreskippedcluster\fP ] +[ \fB--ignoreskippedcluster\fP ] .ad b .br .ad l -[ \fB\-\-logonly\fP ] +[ \fB--logonly\fP ] .ad b .br .ad l -[ \fB\-\-noheadings\fP ] +[ \fB--noheadings\fP ] .ad b .br .ad l -[ \fB\-\-nosuffix\fP ] +[ \fB--nosuffix\fP ] .ad b .br .ad l -[ \fB\-\-readonly\fP ] +[ \fB--readonly\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br .ad l -[ \fB\-\-segments\fP ] +[ \fB--segments\fP ] .ad b .br .ad l -[ \fB\-\-separator\fP \fIString\fP ] +[ \fB--separator\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-shared\fP ] +[ \fB--shared\fP ] .ad b .br .ad l -[ \fB\-\-unbuffered\fP ] +[ \fB--unbuffered\fP ] .ad b .br .ad l -[ \fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ] +[ \fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -130,63 +130,63 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-aligned\fP +\fB--aligned\fP .br -Use with \-\-separator to align the output columns +Use with --separator to align the output columns .ad b .HP .ad l -\fB-a\fP|\fB\-\-all\fP +\fB-a\fP|\fB--all\fP .br Show information about internal LVs. These are components of normal LVs, such as mirrors, @@ -194,7 +194,7 @@ which are not independently accessible, e.g. not mountable. .ad b .HP .ad l -\fB\-\-binary\fP +\fB--binary\fP .br Use binary values "0" or "1" instead of descriptive literal values for columns that have exactly two valid values to report (not counting @@ -202,28 +202,28 @@ the "unknown" value which denotes that the value could not be determined). .ad b .HP .ad l -\fB-c\fP|\fB\-\-colon\fP +\fB-c\fP|\fB--colon\fP .br Generate colon separated output for easier parsing in scripts or programs. Also see vgs(8) which provides considerably more control over the output. .ad b .HP .ad l -\fB-C\fP|\fB\-\-columns\fP +\fB-C\fP|\fB--columns\fP .br Display output in columns, the equivalent of vgs(8). Options listed are the same as options given in vgs(8). .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -232,40 +232,40 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP +\fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP .br See lvmreport(7). .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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\-\-foreign\fP +\fB--foreign\fP .br Report/display foreign VGs that would otherwise be skipped. See lvmsystemid(7) for more information about foreign VGs. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB-H\fP|\fB\-\-history\fP +\fB-H\fP|\fB--history\fP .br Include historical LVs in the output. (This has no effect unless LVs were removed while @@ -273,55 +273,55 @@ lvm.conf metadata/record_lvs_history was enabled. .ad b .HP .ad l -\fB\-\-ignorelockingfailure\fP +\fB--ignorelockingfailure\fP .br Allows a command to continue with read-only metadata operations after locking failures. .ad b .HP .ad l -\fB\-\-ignoreskippedcluster\fP +\fB--ignoreskippedcluster\fP .br Use to avoid exiting with an non-zero status code if the command is run without clustered locking and clustered VGs are skipped. .ad b .HP .ad l -\fB\-\-logonly\fP +\fB--logonly\fP .br Suppress command report and display only log report. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB-m\fP|\fB\-\-maps\fP +\fB-m\fP|\fB--maps\fP .br Display the mapping of logical extents to PVs and physical extents. To map physical extents to logical extents use: -pvs \-\-segments -o+lv_name,seg_start_pe,segtype +pvs --segments -o+lv_name,seg_start_pe,segtype .ad b .HP .ad l -\fB\-\-noheadings\fP +\fB--noheadings\fP .br Suppress the headings line that is normally the first line of output. Useful if grepping the output. .ad b .HP .ad l -\fB\-\-nosuffix\fP +\fB--nosuffix\fP .br -Suppress the suffix on output sizes. Use with \-\-units +Suppress the suffix on output sizes. Use with --units (except h and H) if processing the output. .ad b .HP .ad l -\fB-o\fP|\fB\-\-options\fP \fIString\fP +\fB-o\fP|\fB--options\fP \fIString\fP .br Comma-separated, ordered list of fields to display in columns. String arg syntax is: [+|-|#]Field1[,Field2 ...] @@ -343,7 +343,7 @@ See lvmreport(7) for more information about reporting. .ad b .HP .ad l -\fB-P\fP|\fB\-\-partial\fP +\fB-P\fP|\fB--partial\fP .br When set, the tools will do their best to provide access to VGs that are only partially available (one or more PVs belonging @@ -352,21 +352,21 @@ changed with this option. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-readonly\fP +\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 @@ -380,7 +380,7 @@ actually in use. .ad b .HP .ad l -\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -391,17 +391,17 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB\-\-segments\fP +\fB--segments\fP .br .ad b .HP .ad l -\fB-S\fP|\fB\-\-select\fP \fIString\fP +\fB-S\fP|\fB--select\fP \fIString\fP .br Select objects for processing and reporting based on specified criteria. -The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). +The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7). For reporting commands, one row is displayed for each object matching the criteria. -See \fB\-\-options help\fP for selectable object fields. +See \fB--options help\fP for selectable object fields. Rows can be displayed with an additional "selected" field (-o selected) showing 1 if the row matches the selection and 0 otherwise. For non-reporting commands which process LVM entities, the selection is @@ -409,13 +409,13 @@ used to choose items to process. .ad b .HP .ad l -\fB\-\-separator\fP \fIString\fP +\fB--separator\fP \fIString\fP .br String to use to separate each column. Useful if grepping the output. .ad b .HP .ad l -\fB\-\-shared\fP +\fB--shared\fP .br Report/display shared VGs that would otherwise be skipped when lvmlockd is not being used on the host. @@ -423,14 +423,14 @@ See lvmlockd(8) for more information about shared VGs. .ad b .HP .ad l -\fB-O\fP|\fB\-\-sort\fP \fIString\fP +\fB-O\fP|\fB--sort\fP \fIString\fP .br Comma-separated ordered list of columns to sort by. Replaces the default selection. Precede any column with \fB-\fP for a reverse sort on that column. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -440,37 +440,37 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB\-\-unbuffered\fP +\fB--unbuffered\fP .br Produce output immediately without sorting or aligning the columns properly. .ad b .HP .ad l -\fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP +\fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP .br All sizes are output in these units: human-(r)eadable with '<' rounding indicator, (h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes. Capitalise to use multiples of 1000 (S.I.) instead of 1024. -Custom units can be specified, e.g. \-\-units 3M. +Custom units can be specified, e.g. --units 3M. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -506,7 +506,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/lvextend.8_pregen b/man/lvextend.8_pregen index 0af58ad4f..46f1db40b 100644 --- a/man/lvextend.8_pregen +++ b/man/lvextend.8_pregen @@ -1,6 +1,6 @@ .TH LVEXTEND 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -lvextend \- Add space to a logical volume +lvextend - Add space to a logical volume . .SH SYNOPSIS \fBlvextend\fP \fIoption_args\fP \fIposition_args\fP @@ -11,154 +11,154 @@ lvextend \- Add space to a logical volume .br .P .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 .ad l - \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP + \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB\-\-commandprofile\fP \fIString\fP + \fB--commandprofile\fP \fIString\fP .ad b .br .ad l - \fB\-\-config\fP \fIString\fP + \fB--config\fP \fIString\fP .ad b .br .ad l - \fB-d\fP|\fB\-\-debug\fP + \fB-d\fP|\fB--debug\fP .ad b .br .ad l - \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP + \fB--driverloaded\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB-l\fP|\fB\-\-extents\fP [\fB+\fP]\fINumber\fP[PERCENT] + \fB-l\fP|\fB--extents\fP [\fB+\fP]\fINumber\fP[PERCENT] .ad b .br .ad l - \fB-f\fP|\fB\-\-force\fP + \fB-f\fP|\fB--force\fP .ad b .br .ad l - \fB-h\fP|\fB\-\-help\fP + \fB-h\fP|\fB--help\fP .ad b .br .ad l - \fB\-\-longhelp\fP + \fB--longhelp\fP .ad b .br .ad l - \fB-m\fP|\fB\-\-mirrors\fP \fINumber\fP + \fB-m\fP|\fB--mirrors\fP \fINumber\fP .ad b .br .ad l - \fB-n\fP|\fB\-\-nofsck\fP + \fB-n\fP|\fB--nofsck\fP .ad b .br .ad l - \fB\-\-nosync\fP + \fB--nosync\fP .ad b .br .ad l - \fB\-\-noudevsync\fP + \fB--noudevsync\fP .ad b .br .ad l - \fB\-\-poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] + \fB--poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] .ad b .br .ad l - \fB\-\-profile\fP \fIString\fP + \fB--profile\fP \fIString\fP .ad b .br .ad l - \fB-q\fP|\fB\-\-quiet\fP + \fB-q\fP|\fB--quiet\fP .ad b .br .ad l - \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP + \fB--reportformat\fP \fBbasic\fP|\fBjson\fP .ad b .br .ad l - \fB-r\fP|\fB\-\-resizefs\fP + \fB-r\fP|\fB--resizefs\fP .ad b .br .ad l - \fB-L\fP|\fB\-\-size\fP [\fB+\fP]\fISize\fP[m|UNIT] + \fB-L\fP|\fB--size\fP [\fB+\fP]\fISize\fP[m|UNIT] .ad b .br .ad l - \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP + \fB-i\fP|\fB--stripes\fP \fINumber\fP .ad b .br .ad l - \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] + \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] .ad b .br .ad l - \fB-t\fP|\fB\-\-test\fP + \fB-t\fP|\fB--test\fP .ad b .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--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\-\-usepolicies\fP + \fB--usepolicies\fP .ad b .br .ad l - \fB-v\fP|\fB\-\-verbose\fP + \fB-v\fP|\fB--verbose\fP .ad b .br .ad l - \fB\-\-version\fP + \fB--version\fP .ad b .br .ad l - \fB-y\fP|\fB\-\-yes\fP + \fB-y\fP|\fB--yes\fP .ad b .SH DESCRIPTION lvextend extends the size of an LV. This requires allocating logical extents from the VG's free physical extents. If the extension adds a new LV segment, the new segment will use the existing segment type of the LV. -Extending a copy\-on\-write snapshot LV adds space for COW blocks. +Extending a copy-on-write snapshot LV adds space for COW blocks. Use \fBlvconvert\fP(8) to change the number of data images in a RAID or mirrored LV. -In the usage section below, \fB\-\-size\fP \fISize\fP can be replaced -with \fB\-\-extents\fP \fINumber\fP. See both descriptions +In the usage section below, \fB--size\fP \fISize\fP can be replaced +with \fB--extents\fP \fINumber\fP. See both descriptions the options section. .SH USAGE Extend an LV by a specified size. .br .P -\fBlvextend\fP \fB-L\fP|\fB\-\-size\fP [\fB+\fP]\fISize\fP[m|UNIT] \fILV\fP +\fBlvextend\fP \fB-L\fP|\fB--size\fP [\fB+\fP]\fISize\fP[m|UNIT] \fILV\fP .br .RS 4 .ad l -[ \fB-l\fP|\fB\-\-extents\fP [\fB+\fP]\fINumber\fP[PERCENT] ] +[ \fB-l\fP|\fB--extents\fP [\fB+\fP]\fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-r\fP|\fB\-\-resizefs\fP ] +[ \fB-r\fP|\fB--resizefs\fP ] .ad b .br .ad l -[ \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP ] +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] ] +[ \fB--poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] ] .ad b .br [ COMMON_OPTIONS ] @@ -176,15 +176,15 @@ Extend an LV by specified PV extents. .br .RS 4 .ad l -[ \fB-r\fP|\fB\-\-resizefs\fP ] +[ \fB-r\fP|\fB--resizefs\fP ] .ad b .br .ad l -[ \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP ] +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br [ COMMON_OPTIONS ] @@ -195,15 +195,15 @@ Extend an LV by specified PV extents. Extend a pool metadata SubLV by a specified size. .br .P -\fBlvextend\fP \fB\-\-poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] \fILV\fP\fI_thinpool\fP +\fBlvextend\fP \fB--poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] \fILV\fP\fI_thinpool\fP .br .RS 4 .ad l -[ \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP ] +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .br [ COMMON_OPTIONS ] @@ -217,11 +217,11 @@ Extend a pool metadata SubLV by a specified size. Extend an LV according to a predefined policy. .br .P -\fBlvextend\fP \fB\-\-usepolicies\fP \fILV\fP\fI_snapshot_thinpool\fP +\fBlvextend\fP \fB--usepolicies\fP \fILV\fP\fI_snapshot_thinpool\fP .br .RS 4 .ad l -[ \fB-r\fP|\fB\-\-resizefs\fP ] +[ \fB-r\fP|\fB--resizefs\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -236,39 +236,39 @@ Common options for command: . .RS 4 .ad l -[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-f\fP|\fB\-\-force\fP ] +[ \fB-f\fP|\fB--force\fP ] .ad b .br .ad l -[ \fB-m\fP|\fB\-\-mirrors\fP \fINumber\fP ] +[ \fB-m\fP|\fB--mirrors\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-n\fP|\fB\-\-nofsck\fP ] +[ \fB-n\fP|\fB--nofsck\fP ] .ad b .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 .ad l -[ \fB\-\-nosync\fP ] +[ \fB--nosync\fP ] .ad b .br .ad l -[ \fB\-\-noudevsync\fP ] +[ \fB--noudevsync\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .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--type\fP \fBlinear\fP|\fBstriped\fP|\fBsnapshot\fP|\fBmirror\fP|\fBraid\fP|\fBthin\fP|\fBcache\fP|\fBthin-pool\fP|\fBcache-pool\fP ] .ad b .RE @@ -276,57 +276,57 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .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 .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 @@ -347,21 +347,21 @@ See \fBlvm\fP(8) for more information about allocation. .ad b .HP .ad l -\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP +\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 vgcfgbackup(8) for more information. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -370,24 +370,24 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-l\fP|\fB\-\-extents\fP [\fB+\fP]\fINumber\fP[PERCENT] +\fB-l\fP|\fB--extents\fP [\fB+\fP]\fINumber\fP[PERCENT] .br Specifies the new size of the LV in logical extents. -The \-\-size and \-\-extents options are alternate methods of specifying size. +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 @@ -407,40 +407,40 @@ from the current size. .ad b .HP .ad l -\fB-f\fP|\fB\-\-force\fP ... +\fB-f\fP|\fB--force\fP ... .br Override various checks, confirmations and protections. Use with extreme caution. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB-m\fP|\fB\-\-mirrors\fP \fINumber\fP +\fB-m\fP|\fB--mirrors\fP \fINumber\fP .br Not used. .ad b .HP .ad l -\fB-n\fP|\fB\-\-nofsck\fP +\fB-n\fP|\fB--nofsck\fP .br Do not perform fsck before resizing filesystem when filesystem -requires it. You may need to use \-\-force to proceed with +requires it. You may need to use --force to proceed with this option. .ad b .HP .ad l -\fB\-\-nosync\fP +\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 @@ -457,7 +457,7 @@ and thus do not support initial synchronization. .ad b .HP .ad l -\fB\-\-noudevsync\fP +\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 @@ -466,7 +466,7 @@ ignore the devices LVM creates. .ad b .HP .ad l -\fB\-\-poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] +\fB--poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] .br Specifies the new size of the pool metadata LV. The plus prefix \fB+\fP can be used, in which case @@ -474,21 +474,21 @@ the value is added to the current size. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -499,16 +499,16 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-r\fP|\fB\-\-resizefs\fP +\fB-r\fP|\fB--resizefs\fP .br Resize underlying filesystem together with the LV using fsadm(8). .ad b .HP .ad l -\fB-L\fP|\fB\-\-size\fP [\fB+\fP]\fISize\fP[m|UNIT] +\fB-L\fP|\fB--size\fP [\fB+\fP]\fISize\fP[m|UNIT] .br Specifies the new size of the LV. -The \-\-size and \-\-extents options are alternate methods of specifying size. +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. When the plus \fB+\fP or minus \fB-\fP prefix is used, @@ -517,31 +517,31 @@ from the current size. .ad b .HP .ad l -\fB-i\fP|\fB\-\-stripes\fP \fINumber\fP +\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 +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: 4, raid4/5: 3, raid6: 5.) +(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] +\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 +\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 @@ -551,7 +551,7 @@ back metadata it believes has changed but hasn't. .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 +\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. @@ -561,32 +561,32 @@ 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). +(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\-\-usepolicies\fP +\fB--usepolicies\fP .br Perform an operation according to the policy configured in lvm.conf or a profile. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -625,7 +625,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. @@ -633,17 +633,17 @@ For example, LVM_VG_NAME can generally be substituted for a required VG paramete .SH EXAMPLES Extend the size of an LV by 54MiB, using a specific PV. .br -.B lvextend \-L +54 vg01/lvol10 /dev/sdk3 +.B lvextend -L +54 vg01/lvol10 /dev/sdk3 Extend the size of an LV by the amount of free space on PV /dev/sdk3. This is equivalent to specifying -"\-l +100%PVS" on the command line. +"-l +100%PVS" on the command line. .br .B lvextend vg01/lvol01 /dev/sdk3 Extend an LV by 16MiB using specific physical extents. .br -.B lvextend \-L+16m vg01/lvol01 /dev/sda:8\-9 /dev/sdb:8\-9 +.B lvextend -L+16m vg01/lvol01 /dev/sda:8-9 /dev/sdb:8-9 .SH SEE ALSO .BR lvm (8) diff --git a/man/lvm-config.8_pregen b/man/lvm-config.8_pregen index a1aafbfb4..228fd5dca 100644 --- a/man/lvm-config.8_pregen +++ b/man/lvm-config.8_pregen @@ -1,6 +1,6 @@ .TH LVM CONFIG 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -lvm config \- Display and manipulate configuration information +lvm config - Display and manipulate configuration information . .SH SYNOPSIS \fBlvm config\fP @@ -14,81 +14,81 @@ This command is the same as \fBlvmconfig\fP(8). lvm config produces formatted output from the LVM configuration tree. The sources of the configuration data include \fBlvm.conf\fP(5) and command -line settings from \-\-config. +line settings from --config. .SH USAGE \fBlvm config\fP .br .RS 4 .ad l -[ \fB-f\fP|\fB\-\-file\fP \fIString\fP ] +[ \fB-f\fP|\fB--file\fP \fIString\fP ] .ad b .br .ad l -[ \fB-l\fP|\fB\-\-list\fP ] +[ \fB-l\fP|\fB--list\fP ] .ad b .br .ad l -[ \fB\-\-atversion\fP \fIString\fP ] +[ \fB--atversion\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP ] +[ \fB--typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP ] .ad b .br .ad l -[ \fB\-\-ignoreadvanced\fP ] +[ \fB--ignoreadvanced\fP ] .ad b .br .ad l -[ \fB\-\-ignoreunsupported\fP ] +[ \fB--ignoreunsupported\fP ] .ad b .br .ad l -[ \fB\-\-ignorelocal\fP ] +[ \fB--ignorelocal\fP ] .ad b .br .ad l -[ \fB\-\-mergedconfig\fP ] +[ \fB--mergedconfig\fP ] .ad b .br .ad l -[ \fB\-\-metadataprofile\fP \fIString\fP ] +[ \fB--metadataprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-sinceversion\fP \fIString\fP ] +[ \fB--sinceversion\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-showdeprecated\fP ] +[ \fB--showdeprecated\fP ] .ad b .br .ad l -[ \fB\-\-showunsupported\fP ] +[ \fB--showunsupported\fP ] .ad b .br .ad l -[ \fB\-\-validate\fP ] +[ \fB--validate\fP ] .ad b .br .ad l -[ \fB\-\-withsummary\fP ] +[ \fB--withsummary\fP ] .ad b .br .ad l -[ \fB\-\-withcomments\fP ] +[ \fB--withcomments\fP ] .ad b .br .ad l -[ \fB\-\-withspaces\fP ] +[ \fB--withspaces\fP ] .ad b .br .ad l -[ \fB\-\-unconfigured\fP ] +[ \fB--unconfigured\fP ] .ad b .br .ad l -[ \fB\-\-withversions\fP ] +[ \fB--withversions\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -102,57 +102,57 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-atversion\fP \fIString\fP +\fB--atversion\fP \fIString\fP .br Specify an LVM version in x.y.z format where x is the major version, the y is the minor version and z is the patchlevel (e.g. 2.2.106). @@ -164,14 +164,14 @@ issue a warning message when checking the configuration. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -180,45 +180,45 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-f\fP|\fB\-\-file\fP \fIString\fP +\fB-f\fP|\fB--file\fP \fIString\fP .br Write output to the named file. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-ignoreadvanced\fP +\fB--ignoreadvanced\fP .br Exclude advanced configuration settings from the output. .ad b .HP .ad l -\fB\-\-ignorelocal\fP +\fB--ignorelocal\fP .br Ignore local section. .ad b .HP .ad l -\fB\-\-ignoreunsupported\fP +\fB--ignoreunsupported\fP .br Exclude unsupported configuration settings from the output. These settings are either used for debugging and development purposes only or their support is not @@ -228,24 +228,24 @@ all the other types ignore unsupported settings. .ad b .HP .ad l -\fB-l\fP|\fB\-\-list\fP +\fB-l\fP|\fB--list\fP .br List config settings with summarizing comment. This is the same as using -options \-\-typeconfig list \-\-withsummary. +options --typeconfig list --withsummary. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-mergedconfig\fP +\fB--mergedconfig\fP .br -When the command is run with \-\-config -and/or \-\-commandprofile (or using LVM_COMMAND_PROFILE -environment variable), \-\-profile, or \-\-metadataprofile, +When the command is run with --config +and/or --commandprofile (or using LVM_COMMAND_PROFILE +environment variable), --profile, or --metadataprofile, merge all the contents of the "config cascade" before displaying it. Without merging, only the configuration at the front of the cascade is displayed. @@ -253,39 +253,39 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB\-\-metadataprofile\fP \fIString\fP +\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\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-showdeprecated\fP +\fB--showdeprecated\fP .br Include deprecated configuration settings in the output. These settings are deprecated after a certain version. If a concrete version is specified -with \-\-atversion, deprecated settings are automatically included +with --atversion, deprecated settings are automatically included if the specified version is lower than the version in which the settings were deprecated. The current and diff types include deprecated settings in their output by default, all the other types ignore deprecated settings. .ad b .HP .ad l -\fB\-\-showunsupported\fP +\fB--showunsupported\fP .br Include unsupported configuration settings in the output. These settings are either used for debugging or development purposes only, or their support @@ -295,16 +295,16 @@ output by default, all the other types ignore unsupported settings. .ad b .HP .ad l -\fB\-\-sinceversion\fP \fIString\fP +\fB--sinceversion\fP \fIString\fP .br Specify an LVM version in x.y.z format where x is the major version, the y is the minor version and z is the patchlevel (e.g. 2.2.106). -This option is currently applicable only with \-\-typeconfig new +This option is currently applicable only with --typeconfig new to display all configuration settings introduced since given version. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -314,61 +314,61 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB\-\-typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP +\fB--typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP .br See lvmreport(7). .ad b .HP .ad l -\fB\-\-unconfigured\fP +\fB--unconfigured\fP .br Internal option used for generating config file during build. .ad b .HP .ad l -\fB\-\-validate\fP +\fB--validate\fP .br Validate current configuration used and exit with appropriate return code. The validation is done only for the configuration at the front of the "config cascade". To validate the whole -merged configuration tree, also use \-\-mergedconfig. +merged configuration tree, also use --mergedconfig. The validation is done even if lvm.conf config/checks is disabled. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB\-\-withcomments\fP +\fB--withcomments\fP .br Display a full comment for each configuration node. For deprecated settings, also display comments about deprecation. .ad b .HP .ad l -\fB\-\-withspaces\fP +\fB--withspaces\fP .br Where appropriate, add more spaces in output for better readability. .ad b .HP .ad l -\fB\-\-withsummary\fP +\fB--withsummary\fP .br Display a one line comment for each configuration node. .ad b .HP .ad l -\fB\-\-withversions\fP +\fB--withversions\fP .br Also display a comment containing the version of introduction for each configuration node. If the setting is deprecated, also display @@ -376,7 +376,7 @@ the version since which it is deprecated. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -398,7 +398,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/lvm-dumpconfig.8_pregen b/man/lvm-dumpconfig.8_pregen index 28816adc2..90acf5ff7 100644 --- a/man/lvm-dumpconfig.8_pregen +++ b/man/lvm-dumpconfig.8_pregen @@ -1,6 +1,6 @@ .TH LVM DUMPCONFIG 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -lvm dumpconfig \- Display and manipulate configuration information +lvm dumpconfig - Display and manipulate configuration information . .SH SYNOPSIS \fBlvm dumpconfig\fP @@ -14,81 +14,81 @@ This command is the same as \fBlvmconfig\fP(8). lvm dumpconfig produces formatted output from the LVM configuration tree. The sources of the configuration data include \fBlvm.conf\fP(5) and command -line settings from \-\-config. +line settings from --config. .SH USAGE \fBlvm dumpconfig\fP .br .RS 4 .ad l -[ \fB-f\fP|\fB\-\-file\fP \fIString\fP ] +[ \fB-f\fP|\fB--file\fP \fIString\fP ] .ad b .br .ad l -[ \fB-l\fP|\fB\-\-list\fP ] +[ \fB-l\fP|\fB--list\fP ] .ad b .br .ad l -[ \fB\-\-atversion\fP \fIString\fP ] +[ \fB--atversion\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP ] +[ \fB--typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP ] .ad b .br .ad l -[ \fB\-\-ignoreadvanced\fP ] +[ \fB--ignoreadvanced\fP ] .ad b .br .ad l -[ \fB\-\-ignoreunsupported\fP ] +[ \fB--ignoreunsupported\fP ] .ad b .br .ad l -[ \fB\-\-ignorelocal\fP ] +[ \fB--ignorelocal\fP ] .ad b .br .ad l -[ \fB\-\-mergedconfig\fP ] +[ \fB--mergedconfig\fP ] .ad b .br .ad l -[ \fB\-\-metadataprofile\fP \fIString\fP ] +[ \fB--metadataprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-sinceversion\fP \fIString\fP ] +[ \fB--sinceversion\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-showdeprecated\fP ] +[ \fB--showdeprecated\fP ] .ad b .br .ad l -[ \fB\-\-showunsupported\fP ] +[ \fB--showunsupported\fP ] .ad b .br .ad l -[ \fB\-\-validate\fP ] +[ \fB--validate\fP ] .ad b .br .ad l -[ \fB\-\-withsummary\fP ] +[ \fB--withsummary\fP ] .ad b .br .ad l -[ \fB\-\-withcomments\fP ] +[ \fB--withcomments\fP ] .ad b .br .ad l -[ \fB\-\-withspaces\fP ] +[ \fB--withspaces\fP ] .ad b .br .ad l -[ \fB\-\-unconfigured\fP ] +[ \fB--unconfigured\fP ] .ad b .br .ad l -[ \fB\-\-withversions\fP ] +[ \fB--withversions\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -102,57 +102,57 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-atversion\fP \fIString\fP +\fB--atversion\fP \fIString\fP .br Specify an LVM version in x.y.z format where x is the major version, the y is the minor version and z is the patchlevel (e.g. 2.2.106). @@ -164,14 +164,14 @@ issue a warning message when checking the configuration. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -180,45 +180,45 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-f\fP|\fB\-\-file\fP \fIString\fP +\fB-f\fP|\fB--file\fP \fIString\fP .br Write output to the named file. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-ignoreadvanced\fP +\fB--ignoreadvanced\fP .br Exclude advanced configuration settings from the output. .ad b .HP .ad l -\fB\-\-ignorelocal\fP +\fB--ignorelocal\fP .br Ignore local section. .ad b .HP .ad l -\fB\-\-ignoreunsupported\fP +\fB--ignoreunsupported\fP .br Exclude unsupported configuration settings from the output. These settings are either used for debugging and development purposes only or their support is not @@ -228,24 +228,24 @@ all the other types ignore unsupported settings. .ad b .HP .ad l -\fB-l\fP|\fB\-\-list\fP +\fB-l\fP|\fB--list\fP .br List config settings with summarizing comment. This is the same as using -options \-\-typeconfig list \-\-withsummary. +options --typeconfig list --withsummary. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-mergedconfig\fP +\fB--mergedconfig\fP .br -When the command is run with \-\-config -and/or \-\-commandprofile (or using LVM_COMMAND_PROFILE -environment variable), \-\-profile, or \-\-metadataprofile, +When the command is run with --config +and/or --commandprofile (or using LVM_COMMAND_PROFILE +environment variable), --profile, or --metadataprofile, merge all the contents of the "config cascade" before displaying it. Without merging, only the configuration at the front of the cascade is displayed. @@ -253,39 +253,39 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB\-\-metadataprofile\fP \fIString\fP +\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\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-showdeprecated\fP +\fB--showdeprecated\fP .br Include deprecated configuration settings in the output. These settings are deprecated after a certain version. If a concrete version is specified -with \-\-atversion, deprecated settings are automatically included +with --atversion, deprecated settings are automatically included if the specified version is lower than the version in which the settings were deprecated. The current and diff types include deprecated settings in their output by default, all the other types ignore deprecated settings. .ad b .HP .ad l -\fB\-\-showunsupported\fP +\fB--showunsupported\fP .br Include unsupported configuration settings in the output. These settings are either used for debugging or development purposes only, or their support @@ -295,16 +295,16 @@ output by default, all the other types ignore unsupported settings. .ad b .HP .ad l -\fB\-\-sinceversion\fP \fIString\fP +\fB--sinceversion\fP \fIString\fP .br Specify an LVM version in x.y.z format where x is the major version, the y is the minor version and z is the patchlevel (e.g. 2.2.106). -This option is currently applicable only with \-\-typeconfig new +This option is currently applicable only with --typeconfig new to display all configuration settings introduced since given version. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -314,61 +314,61 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB\-\-typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP +\fB--typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP .br See lvmreport(7). .ad b .HP .ad l -\fB\-\-unconfigured\fP +\fB--unconfigured\fP .br Internal option used for generating config file during build. .ad b .HP .ad l -\fB\-\-validate\fP +\fB--validate\fP .br Validate current configuration used and exit with appropriate return code. The validation is done only for the configuration at the front of the "config cascade". To validate the whole -merged configuration tree, also use \-\-mergedconfig. +merged configuration tree, also use --mergedconfig. The validation is done even if lvm.conf config/checks is disabled. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB\-\-withcomments\fP +\fB--withcomments\fP .br Display a full comment for each configuration node. For deprecated settings, also display comments about deprecation. .ad b .HP .ad l -\fB\-\-withspaces\fP +\fB--withspaces\fP .br Where appropriate, add more spaces in output for better readability. .ad b .HP .ad l -\fB\-\-withsummary\fP +\fB--withsummary\fP .br Display a one line comment for each configuration node. .ad b .HP .ad l -\fB\-\-withversions\fP +\fB--withversions\fP .br Also display a comment containing the version of introduction for each configuration node. If the setting is deprecated, also display @@ -376,7 +376,7 @@ the version since which it is deprecated. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -398,7 +398,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/lvm-fullreport.8_pregen b/man/lvm-fullreport.8_pregen index feb7f8da5..bfc5cd337 100644 --- a/man/lvm-fullreport.8_pregen +++ b/man/lvm-fullreport.8_pregen @@ -1,6 +1,6 @@ .TH LVM FULLREPORT 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -lvm fullreport \- Display full report +lvm fullreport - Display full report . .SH SYNOPSIS \fBlvm fullreport\fP @@ -21,103 +21,103 @@ if information changes between commands. .br .RS 4 .ad l -[ \fB-a\fP|\fB\-\-all\fP ] +[ \fB-a\fP|\fB--all\fP ] .ad b .br .ad l -[ \fB-o\fP|\fB\-\-options\fP \fIString\fP ] +[ \fB-o\fP|\fB--options\fP \fIString\fP ] .ad b .br .ad l -[ \fB-P\fP|\fB\-\-partial\fP ] +[ \fB-P\fP|\fB--partial\fP ] .ad b .br .ad l -[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] +[ \fB-S\fP|\fB--select\fP \fIString\fP ] .ad b .br .ad l -[ \fB-O\fP|\fB\-\-sort\fP \fIString\fP ] +[ \fB-O\fP|\fB--sort\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-aligned\fP ] +[ \fB--aligned\fP ] .ad b .br .ad l -[ \fB\-\-binary\fP ] +[ \fB--binary\fP ] .ad b .br .ad l -[ \fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ] +[ \fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ] .ad b .br .ad l -[ \fB\-\-foreign\fP ] +[ \fB--foreign\fP ] .ad b .br .ad l -[ \fB\-\-ignorelockingfailure\fP ] +[ \fB--ignorelockingfailure\fP ] .ad b .br .ad l -[ \fB\-\-ignoreskippedcluster\fP ] +[ \fB--ignoreskippedcluster\fP ] .ad b .br .ad l -[ \fB\-\-logonly\fP ] +[ \fB--logonly\fP ] .ad b .br .ad l -[ \fB\-\-nameprefixes\fP ] +[ \fB--nameprefixes\fP ] .ad b .br .ad l -[ \fB\-\-noheadings\fP ] +[ \fB--noheadings\fP ] .ad b .br .ad l -[ \fB\-\-nolocking\fP ] +[ \fB--nolocking\fP ] .ad b .br .ad l -[ \fB\-\-nosuffix\fP ] +[ \fB--nosuffix\fP ] .ad b .br .ad l -[ \fB\-\-readonly\fP ] +[ \fB--readonly\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br .ad l -[ \fB\-\-rows\fP ] +[ \fB--rows\fP ] .ad b .br .ad l -[ \fB\-\-separator\fP \fIString\fP ] +[ \fB--separator\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-shared\fP ] +[ \fB--shared\fP ] .ad b .br .ad l -[ \fB\-\-trustcache\fP ] +[ \fB--trustcache\fP ] .ad b .br .ad l -[ \fB\-\-unbuffered\fP ] +[ \fB--unbuffered\fP ] .ad b .br .ad l -[ \fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ] +[ \fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ] .ad b .br .ad l -[ \fB\-\-unquoted\fP ] +[ \fB--unquoted\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -131,68 +131,68 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-aligned\fP +\fB--aligned\fP .br -Use with \-\-separator to align the output columns +Use with --separator to align the output columns .ad b .HP .ad l -\fB-a\fP|\fB\-\-all\fP +\fB-a\fP|\fB--all\fP .br .ad b .HP .ad l -\fB\-\-binary\fP +\fB--binary\fP .br Use binary values "0" or "1" instead of descriptive literal values for columns that have exactly two valid values to report (not counting @@ -200,14 +200,14 @@ the "unknown" value which denotes that the value could not be determined). .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -216,94 +216,94 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP +\fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP .br See lvmreport(7). .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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\-\-foreign\fP +\fB--foreign\fP .br Report/display foreign VGs that would otherwise be skipped. See lvmsystemid(7) for more information about foreign VGs. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-ignorelockingfailure\fP +\fB--ignorelockingfailure\fP .br Allows a command to continue with read-only metadata operations after locking failures. .ad b .HP .ad l -\fB\-\-ignoreskippedcluster\fP +\fB--ignoreskippedcluster\fP .br Use to avoid exiting with an non-zero status code if the command is run without clustered locking and clustered VGs are skipped. .ad b .HP .ad l -\fB\-\-logonly\fP +\fB--logonly\fP .br Suppress command report and display only log report. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-nameprefixes\fP +\fB--nameprefixes\fP .br Add an "LVM2_" prefix plus the field name to the output. Useful -with \-\-noheadings to produce a list of field=value pairs that can +with --noheadings to produce a list of field=value pairs that can be used to set environment variables (for example, in udev rules). .ad b .HP .ad l -\fB\-\-noheadings\fP +\fB--noheadings\fP .br Suppress the headings line that is normally the first line of output. Useful if grepping the output. .ad b .HP .ad l -\fB\-\-nolocking\fP +\fB--nolocking\fP .br Disable locking. .ad b .HP .ad l -\fB\-\-nosuffix\fP +\fB--nosuffix\fP .br -Suppress the suffix on output sizes. Use with \-\-units +Suppress the suffix on output sizes. Use with --units (except h and H) if processing the output. .ad b .HP .ad l -\fB-o\fP|\fB\-\-options\fP \fIString\fP +\fB-o\fP|\fB--options\fP \fIString\fP .br Comma-separated, ordered list of fields to display in columns. String arg syntax is: [+|-|#]Field1[,Field2 ...] @@ -325,7 +325,7 @@ See lvmreport(7) for more information about reporting. .ad b .HP .ad l -\fB-P\fP|\fB\-\-partial\fP +\fB-P\fP|\fB--partial\fP .br When set, the tools will do their best to provide access to VGs that are only partially available (one or more PVs belonging @@ -334,21 +334,21 @@ changed with this option. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-readonly\fP +\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 @@ -362,7 +362,7 @@ actually in use. .ad b .HP .ad l -\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -373,18 +373,18 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB\-\-rows\fP +\fB--rows\fP .br Output columns as rows. .ad b .HP .ad l -\fB-S\fP|\fB\-\-select\fP \fIString\fP +\fB-S\fP|\fB--select\fP \fIString\fP .br Select objects for processing and reporting based on specified criteria. -The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). +The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7). For reporting commands, one row is displayed for each object matching the criteria. -See \fB\-\-options help\fP for selectable object fields. +See \fB--options help\fP for selectable object fields. Rows can be displayed with an additional "selected" field (-o selected) showing 1 if the row matches the selection and 0 otherwise. For non-reporting commands which process LVM entities, the selection is @@ -392,13 +392,13 @@ used to choose items to process. .ad b .HP .ad l -\fB\-\-separator\fP \fIString\fP +\fB--separator\fP \fIString\fP .br String to use to separate each column. Useful if grepping the output. .ad b .HP .ad l -\fB\-\-shared\fP +\fB--shared\fP .br Report/display shared VGs that would otherwise be skipped when lvmlockd is not being used on the host. @@ -406,14 +406,14 @@ See lvmlockd(8) for more information about shared VGs. .ad b .HP .ad l -\fB-O\fP|\fB\-\-sort\fP \fIString\fP +\fB-O\fP|\fB--sort\fP \fIString\fP .br Comma-separated ordered list of columns to sort by. Replaces the default selection. Precede any column with \fB-\fP for a reverse sort on that column. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -423,50 +423,50 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB\-\-trustcache\fP +\fB--trustcache\fP .br Avoids certain device scanning during command processing. Do not use. .ad b .HP .ad l -\fB\-\-unbuffered\fP +\fB--unbuffered\fP .br Produce output immediately without sorting or aligning the columns properly. .ad b .HP .ad l -\fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP +\fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP .br All sizes are output in these units: human-(r)eadable with '<' rounding indicator, (h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes. Capitalise to use multiples of 1000 (S.I.) instead of 1024. -Custom units can be specified, e.g. \-\-units 3M. +Custom units can be specified, e.g. --units 3M. .ad b .HP .ad l -\fB\-\-unquoted\fP +\fB--unquoted\fP .br -When used with \-\-nameprefixes, output values in the field=value +When used with --nameprefixes, output values in the field=value pairs are not quoted. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -492,7 +492,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/lvm-lvpoll.8_pregen b/man/lvm-lvpoll.8_pregen index 20af1be6c..b99a45dcc 100644 --- a/man/lvm-lvpoll.8_pregen +++ b/man/lvm-lvpoll.8_pregen @@ -1,6 +1,6 @@ .TH LVM LVPOLL 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -lvm lvpoll \- Continue already initiated poll operation on a logical volume +lvm lvpoll - Continue already initiated poll operation on a logical volume . .SH SYNOPSIS \fBlvm lvpoll\fP \fIoption_args\fP \fIposition_args\fP @@ -13,23 +13,23 @@ complete \fBlvconvert\fP(8) and \fBpvmove\fP(8) operations. lvpoll itself does not initiate these operations and should not normally need to be run directly. .SH USAGE -\fBlvm lvpoll\fP \fB\-\-polloperation\fP \fBpvmove\fP|\fBconvert\fP|\fBmerge\fP|\fBmerge_thin\fP \fILV\fP ... +\fBlvm lvpoll\fP \fB--polloperation\fP \fBpvmove\fP|\fBconvert\fP|\fBmerge\fP|\fBmerge_thin\fP \fILV\fP ... .br .RS 4 .ad l -[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-i\fP|\fB\-\-interval\fP \fINumber\fP ] +[ \fB-i\fP|\fB--interval\fP \fINumber\fP ] .ad b .br .ad l -[ \fB\-\-abort\fP ] +[ \fB--abort\fP ] .ad b .br .ad l -[ \fB\-\-handlemissingpvs\fP ] +[ \fB--handlemissingpvs\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -40,77 +40,77 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-abort\fP +\fB--abort\fP .br Stop processing a poll operation in lvmpolld. .ad b .HP .ad l -\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP +\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 vgcfgbackup(8) for more information. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -119,66 +119,66 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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\-\-handlemissingpvs\fP +\fB--handlemissingpvs\fP .br Allows a polling operation to continue when PVs are missing, e.g. for repairs due to faulty devices. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB-i\fP|\fB\-\-interval\fP \fINumber\fP +\fB-i\fP|\fB--interval\fP \fINumber\fP .br Report progress at regular intervals. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-polloperation\fP \fBpvmove\fP|\fBconvert\fP|\fBmerge\fP|\fBmerge_thin\fP +\fB--polloperation\fP \fBpvmove\fP|\fBconvert\fP|\fBmerge\fP|\fBmerge_thin\fP .br The command to perform from lvmpolld. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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-t\fP|\fB\-\-test\fP +\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 @@ -188,20 +188,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -228,7 +228,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. @@ -243,27 +243,27 @@ To find the name of the pvmove LV that was created by an original Continue polling a pvmove operation. .br -.B lvm lvpoll \-\-polloperation pvmove vg00/pvmove0 +.B lvm lvpoll --polloperation pvmove vg00/pvmove0 Abort a pvmove operation. .br -.B lvm lvpoll \-\-polloperation pvmove \-\-abort vg00/pvmove0 +.B lvm lvpoll --polloperation pvmove --abort vg00/pvmove0 Continue polling a mirror conversion. .br -.B lvm lvpoll \-\-polloperation convert vg00/lvmirror +.B lvm lvpoll --polloperation convert vg00/lvmirror Continue mirror repair. .br -.B lvm lvpoll \-\-polloperation convert vg/damaged_mirror \-\-handlemissingpvs +.B lvm lvpoll --polloperation convert vg/damaged_mirror --handlemissingpvs Continue snapshot merge. .br -.B lvm lvpoll \-\-polloperation merge vg/snapshot_old +.B lvm lvpoll --polloperation merge vg/snapshot_old Continue thin snapshot merge. .br -.B lvm lvpoll \-\-polloperation merge_thin vg/thin_snapshot +.B lvm lvpoll --polloperation merge_thin vg/thin_snapshot .SH SEE ALSO .BR lvm (8) diff --git a/man/lvmconfig.8_pregen b/man/lvmconfig.8_pregen index dc9ff65f6..5f2306ee7 100644 --- a/man/lvmconfig.8_pregen +++ b/man/lvmconfig.8_pregen @@ -1,6 +1,6 @@ .TH LVMCONFIG 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -lvmconfig \- Display and manipulate configuration information +lvmconfig - Display and manipulate configuration information . .SH SYNOPSIS \fBlvmconfig\fP @@ -12,81 +12,81 @@ lvmconfig \- Display and manipulate configuration information .SH DESCRIPTION lvmconfig produces formatted output from the LVM configuration tree. The sources of the configuration data include \fBlvm.conf\fP(5) and command -line settings from \-\-config. +line settings from --config. .SH USAGE \fBlvmconfig\fP .br .RS 4 .ad l -[ \fB-f\fP|\fB\-\-file\fP \fIString\fP ] +[ \fB-f\fP|\fB--file\fP \fIString\fP ] .ad b .br .ad l -[ \fB-l\fP|\fB\-\-list\fP ] +[ \fB-l\fP|\fB--list\fP ] .ad b .br .ad l -[ \fB\-\-atversion\fP \fIString\fP ] +[ \fB--atversion\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP ] +[ \fB--typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP ] .ad b .br .ad l -[ \fB\-\-ignoreadvanced\fP ] +[ \fB--ignoreadvanced\fP ] .ad b .br .ad l -[ \fB\-\-ignoreunsupported\fP ] +[ \fB--ignoreunsupported\fP ] .ad b .br .ad l -[ \fB\-\-ignorelocal\fP ] +[ \fB--ignorelocal\fP ] .ad b .br .ad l -[ \fB\-\-mergedconfig\fP ] +[ \fB--mergedconfig\fP ] .ad b .br .ad l -[ \fB\-\-metadataprofile\fP \fIString\fP ] +[ \fB--metadataprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-sinceversion\fP \fIString\fP ] +[ \fB--sinceversion\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-showdeprecated\fP ] +[ \fB--showdeprecated\fP ] .ad b .br .ad l -[ \fB\-\-showunsupported\fP ] +[ \fB--showunsupported\fP ] .ad b .br .ad l -[ \fB\-\-validate\fP ] +[ \fB--validate\fP ] .ad b .br .ad l -[ \fB\-\-withsummary\fP ] +[ \fB--withsummary\fP ] .ad b .br .ad l -[ \fB\-\-withcomments\fP ] +[ \fB--withcomments\fP ] .ad b .br .ad l -[ \fB\-\-withspaces\fP ] +[ \fB--withspaces\fP ] .ad b .br .ad l -[ \fB\-\-unconfigured\fP ] +[ \fB--unconfigured\fP ] .ad b .br .ad l -[ \fB\-\-withversions\fP ] +[ \fB--withversions\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -100,57 +100,57 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-atversion\fP \fIString\fP +\fB--atversion\fP \fIString\fP .br Specify an LVM version in x.y.z format where x is the major version, the y is the minor version and z is the patchlevel (e.g. 2.2.106). @@ -162,14 +162,14 @@ issue a warning message when checking the configuration. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -178,45 +178,45 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-f\fP|\fB\-\-file\fP \fIString\fP +\fB-f\fP|\fB--file\fP \fIString\fP .br Write output to the named file. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-ignoreadvanced\fP +\fB--ignoreadvanced\fP .br Exclude advanced configuration settings from the output. .ad b .HP .ad l -\fB\-\-ignorelocal\fP +\fB--ignorelocal\fP .br Ignore local section. .ad b .HP .ad l -\fB\-\-ignoreunsupported\fP +\fB--ignoreunsupported\fP .br Exclude unsupported configuration settings from the output. These settings are either used for debugging and development purposes only or their support is not @@ -226,24 +226,24 @@ all the other types ignore unsupported settings. .ad b .HP .ad l -\fB-l\fP|\fB\-\-list\fP +\fB-l\fP|\fB--list\fP .br List config settings with summarizing comment. This is the same as using -options \-\-typeconfig list \-\-withsummary. +options --typeconfig list --withsummary. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-mergedconfig\fP +\fB--mergedconfig\fP .br -When the command is run with \-\-config -and/or \-\-commandprofile (or using LVM_COMMAND_PROFILE -environment variable), \-\-profile, or \-\-metadataprofile, +When the command is run with --config +and/or --commandprofile (or using LVM_COMMAND_PROFILE +environment variable), --profile, or --metadataprofile, merge all the contents of the "config cascade" before displaying it. Without merging, only the configuration at the front of the cascade is displayed. @@ -251,39 +251,39 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB\-\-metadataprofile\fP \fIString\fP +\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\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-showdeprecated\fP +\fB--showdeprecated\fP .br Include deprecated configuration settings in the output. These settings are deprecated after a certain version. If a concrete version is specified -with \-\-atversion, deprecated settings are automatically included +with --atversion, deprecated settings are automatically included if the specified version is lower than the version in which the settings were deprecated. The current and diff types include deprecated settings in their output by default, all the other types ignore deprecated settings. .ad b .HP .ad l -\fB\-\-showunsupported\fP +\fB--showunsupported\fP .br Include unsupported configuration settings in the output. These settings are either used for debugging or development purposes only, or their support @@ -293,16 +293,16 @@ output by default, all the other types ignore unsupported settings. .ad b .HP .ad l -\fB\-\-sinceversion\fP \fIString\fP +\fB--sinceversion\fP \fIString\fP .br Specify an LVM version in x.y.z format where x is the major version, the y is the minor version and z is the patchlevel (e.g. 2.2.106). -This option is currently applicable only with \-\-typeconfig new +This option is currently applicable only with --typeconfig new to display all configuration settings introduced since given version. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -312,61 +312,61 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB\-\-typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP +\fB--typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP .br See lvmreport(7). .ad b .HP .ad l -\fB\-\-unconfigured\fP +\fB--unconfigured\fP .br Internal option used for generating config file during build. .ad b .HP .ad l -\fB\-\-validate\fP +\fB--validate\fP .br Validate current configuration used and exit with appropriate return code. The validation is done only for the configuration at the front of the "config cascade". To validate the whole -merged configuration tree, also use \-\-mergedconfig. +merged configuration tree, also use --mergedconfig. The validation is done even if lvm.conf config/checks is disabled. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB\-\-withcomments\fP +\fB--withcomments\fP .br Display a full comment for each configuration node. For deprecated settings, also display comments about deprecation. .ad b .HP .ad l -\fB\-\-withspaces\fP +\fB--withspaces\fP .br Where appropriate, add more spaces in output for better readability. .ad b .HP .ad l -\fB\-\-withsummary\fP +\fB--withsummary\fP .br Display a one line comment for each configuration node. .ad b .HP .ad l -\fB\-\-withversions\fP +\fB--withversions\fP .br Also display a comment containing the version of introduction for each configuration node. If the setting is deprecated, also display @@ -374,7 +374,7 @@ the version since which it is deprecated. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -396,7 +396,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/lvmdiskscan.8_pregen b/man/lvmdiskscan.8_pregen index f6b3c53a6..4e390d55e 100644 --- a/man/lvmdiskscan.8_pregen +++ b/man/lvmdiskscan.8_pregen @@ -1,6 +1,6 @@ .TH LVMDISKSCAN 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -lvmdiskscan \- List devices that may be used as physical volumes +lvmdiskscan - List devices that may be used as physical volumes . .SH SYNOPSIS \fBlvmdiskscan\fP @@ -20,11 +20,11 @@ This command is deprecated, use \fBpvs\fP instead. .br .RS 4 .ad l -[ \fB-l\fP|\fB\-\-lvmpartition\fP ] +[ \fB-l\fP|\fB--lvmpartition\fP ] .ad b .br .ad l -[ \fB\-\-readonly\fP ] +[ \fB--readonly\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -35,64 +35,64 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -101,53 +101,53 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB-l\fP|\fB\-\-lvmpartition\fP +\fB-l\fP|\fB--lvmpartition\fP .br Only report PVs. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-readonly\fP +\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 @@ -161,7 +161,7 @@ actually in use. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -171,20 +171,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -206,7 +206,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/lvreduce.8_pregen b/man/lvreduce.8_pregen index cdc02cfd6..1781600fe 100644 --- a/man/lvreduce.8_pregen +++ b/man/lvreduce.8_pregen @@ -1,6 +1,6 @@ .TH LVREDUCE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -lvreduce \- Reduce the size of a logical volume +lvreduce - Reduce the size of a logical volume . .SH SYNOPSIS \fBlvreduce\fP \fIoption_args\fP \fIposition_args\fP @@ -9,7 +9,7 @@ lvreduce \- Reduce the size of a logical volume .br .SH DESCRIPTION lvreduce reduces the size of an LV. The freed logical extents are returned -to the VG to be used by other LVs. A copy\-on\-write snapshot LV can also +to the VG to be used by other LVs. A copy-on-write snapshot LV can also be reduced if less space is needed to hold COW blocks. Use \fBlvconvert\fP(8) to change the number of data images in a RAID or mirrored LV. @@ -23,39 +23,39 @@ Sizes will be rounded if necessary. For example, the LV size must be an exact number of extents, and the size of a striped segment must be a multiple of the number of stripes. -In the usage section below, \fB\-\-size\fP \fISize\fP can be replaced -with \fB\-\-extents\fP \fINumber\fP. See both descriptions +In the usage section below, \fB--size\fP \fISize\fP can be replaced +with \fB--extents\fP \fINumber\fP. See both descriptions the options section. .SH USAGE -\fBlvreduce\fP \fB-L\fP|\fB\-\-size\fP [\fB-\fP]\fISize\fP[m|UNIT] \fILV\fP +\fBlvreduce\fP \fB-L\fP|\fB--size\fP [\fB-\fP]\fISize\fP[m|UNIT] \fILV\fP .br .RS 4 .ad l -[ \fB-l\fP|\fB\-\-extents\fP [\fB-\fP]\fINumber\fP[PERCENT] ] +[ \fB-l\fP|\fB--extents\fP [\fB-\fP]\fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-f\fP|\fB\-\-force\fP ] +[ \fB-f\fP|\fB--force\fP ] .ad b .br .ad l -[ \fB-n\fP|\fB\-\-nofsck\fP ] +[ \fB-n\fP|\fB--nofsck\fP ] .ad b .br .ad l -[ \fB-r\fP|\fB\-\-resizefs\fP ] +[ \fB-r\fP|\fB--resizefs\fP ] .ad b .br .ad l -[ \fB\-\-noudevsync\fP ] +[ \fB--noudevsync\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -66,71 +66,71 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP +\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 vgcfgbackup(8) for more information. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -139,24 +139,24 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-l\fP|\fB\-\-extents\fP [\fB-\fP]\fINumber\fP[PERCENT] +\fB-l\fP|\fB--extents\fP [\fB-\fP]\fINumber\fP[PERCENT] .br Specifies the new size of the LV in logical extents. -The \-\-size and \-\-extents options are alternate methods of specifying size. +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 @@ -176,34 +176,34 @@ from the current size. .ad b .HP .ad l -\fB-f\fP|\fB\-\-force\fP ... +\fB-f\fP|\fB--force\fP ... .br Override various checks, confirmations and protections. Use with extreme caution. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB-n\fP|\fB\-\-nofsck\fP +\fB-n\fP|\fB--nofsck\fP .br Do not perform fsck before resizing filesystem when filesystem -requires it. You may need to use \-\-force to proceed with +requires it. You may need to use --force to proceed with this option. .ad b .HP .ad l -\fB\-\-noudevsync\fP +\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 @@ -212,21 +212,21 @@ ignore the devices LVM creates. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -237,16 +237,16 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-r\fP|\fB\-\-resizefs\fP +\fB-r\fP|\fB--resizefs\fP .br Resize underlying filesystem together with the LV using fsadm(8). .ad b .HP .ad l -\fB-L\fP|\fB\-\-size\fP [\fB-\fP]\fISize\fP[m|UNIT] +\fB-L\fP|\fB--size\fP [\fB-\fP]\fISize\fP[m|UNIT] .br Specifies the new size of the LV. -The \-\-size and \-\-extents options are alternate methods of specifying size. +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. When the plus \fB+\fP or minus \fB-\fP prefix is used, @@ -255,7 +255,7 @@ from the current size. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -265,20 +265,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -305,7 +305,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. @@ -314,7 +314,7 @@ For example, LVM_VG_NAME can generally be substituted for a required VG paramete Reduce the size of an LV by 3 logical extents: .br -.B lvreduce \-l \-3 vg00/lvol1 +.B lvreduce -l -3 vg00/lvol1 .SH SEE ALSO .BR lvm (8) diff --git a/man/lvremove.8_pregen b/man/lvremove.8_pregen index 40b5657f0..5edb4efda 100644 --- a/man/lvremove.8_pregen +++ b/man/lvremove.8_pregen @@ -1,6 +1,6 @@ .TH LVREMOVE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -lvremove \- Remove logical volume(s) from the system +lvremove - Remove logical volume(s) from the system . .SH SYNOPSIS \fBlvremove\fP \fIposition_args\fP @@ -39,27 +39,27 @@ former LV completely. .br .RS 4 .ad l -[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-f\fP|\fB\-\-force\fP ] +[ \fB-f\fP|\fB--force\fP ] .ad b .br .ad l -[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] +[ \fB-S\fP|\fB--select\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-nohistory\fP ] +[ \fB--nohistory\fP ] .ad b .br .ad l -[ \fB\-\-noudevsync\fP ] +[ \fB--noudevsync\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -70,71 +70,71 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP +\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 vgcfgbackup(8) for more information. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -143,40 +143,40 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-f\fP|\fB\-\-force\fP ... +\fB-f\fP|\fB--force\fP ... .br Override various checks, confirmations and protections. Use with extreme caution. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-nohistory\fP +\fB--nohistory\fP .br Do not record history of LVs being removed. This has no effect unless the configuration setting @@ -184,7 +184,7 @@ metadata/record_lvs_history is enabled. .ad b .HP .ad l -\fB\-\-noudevsync\fP +\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 @@ -193,21 +193,21 @@ ignore the devices LVM creates. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -218,12 +218,12 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-S\fP|\fB\-\-select\fP \fIString\fP +\fB-S\fP|\fB--select\fP \fIString\fP .br Select objects for processing and reporting based on specified criteria. -The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). +The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7). For reporting commands, one row is displayed for each object matching the criteria. -See \fB\-\-options help\fP for selectable object fields. +See \fB--options help\fP for selectable object fields. Rows can be displayed with an additional "selected" field (-o selected) showing 1 if the row matches the selection and 0 otherwise. For non-reporting commands which process LVM entities, the selection is @@ -231,7 +231,7 @@ used to choose items to process. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -241,20 +241,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -279,7 +279,7 @@ in place of a VG, LV or PV. \fISelect\fP .br Select indicates that a required positional parameter can -be omitted if the \fB\-\-select\fP option is used. +be omitted if the \fB--select\fP option is used. No arg appears in this position. .HP \fIString\fP @@ -296,7 +296,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. @@ -304,7 +304,7 @@ For example, LVM_VG_NAME can generally be substituted for a required VG paramete .SH EXAMPLES Remove an active LV without asking for confirmation. .br -.B lvremove \-f vg00/lvol1 +.B lvremove -f vg00/lvol1 Remove all LVs the specified VG. .br diff --git a/man/lvrename.8_pregen b/man/lvrename.8_pregen index 679fe3945..de41077ab 100644 --- a/man/lvrename.8_pregen +++ b/man/lvrename.8_pregen @@ -1,6 +1,6 @@ .TH LVRENAME 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -lvrename \- Rename a logical volume +lvrename - Rename a logical volume . .SH SYNOPSIS \fBlvrename\fP \fIposition_args\fP @@ -29,15 +29,15 @@ Common options for command: . .RS 4 .ad l -[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-noudevsync\fP ] +[ \fB--noudevsync\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .RE @@ -45,71 +45,71 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP +\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 vgcfgbackup(8) for more information. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -118,33 +118,33 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-noudevsync\fP +\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 @@ -153,21 +153,21 @@ ignore the devices LVM creates. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -178,7 +178,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -188,20 +188,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -232,7 +232,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/lvresize.8_pregen b/man/lvresize.8_pregen index eaa2a3f44..3e12aa249 100644 --- a/man/lvresize.8_pregen +++ b/man/lvresize.8_pregen @@ -1,6 +1,6 @@ .TH LVRESIZE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -lvresize \- Resize a logical volume +lvresize - Resize a logical volume . .SH SYNOPSIS \fBlvresize\fP \fIoption_args\fP \fIposition_args\fP @@ -11,132 +11,132 @@ lvresize \- Resize a logical volume .br .P .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 .ad l - \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP + \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB\-\-commandprofile\fP \fIString\fP + \fB--commandprofile\fP \fIString\fP .ad b .br .ad l - \fB\-\-config\fP \fIString\fP + \fB--config\fP \fIString\fP .ad b .br .ad l - \fB-d\fP|\fB\-\-debug\fP + \fB-d\fP|\fB--debug\fP .ad b .br .ad l - \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP + \fB--driverloaded\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB-l\fP|\fB\-\-extents\fP [\fB+\fP|\fB-\fP]\fINumber\fP[PERCENT] + \fB-l\fP|\fB--extents\fP [\fB+\fP|\fB-\fP]\fINumber\fP[PERCENT] .ad b .br .ad l - \fB-f\fP|\fB\-\-force\fP + \fB-f\fP|\fB--force\fP .ad b .br .ad l - \fB-h\fP|\fB\-\-help\fP + \fB-h\fP|\fB--help\fP .ad b .br .ad l - \fB\-\-longhelp\fP + \fB--longhelp\fP .ad b .br .ad l - \fB-n\fP|\fB\-\-nofsck\fP + \fB-n\fP|\fB--nofsck\fP .ad b .br .ad l - \fB\-\-nosync\fP + \fB--nosync\fP .ad b .br .ad l - \fB\-\-noudevsync\fP + \fB--noudevsync\fP .ad b .br .ad l - \fB\-\-poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] + \fB--poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] .ad b .br .ad l - \fB\-\-profile\fP \fIString\fP + \fB--profile\fP \fIString\fP .ad b .br .ad l - \fB-q\fP|\fB\-\-quiet\fP + \fB-q\fP|\fB--quiet\fP .ad b .br .ad l - \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP + \fB--reportformat\fP \fBbasic\fP|\fBjson\fP .ad b .br .ad l - \fB-r\fP|\fB\-\-resizefs\fP + \fB-r\fP|\fB--resizefs\fP .ad b .br .ad l - \fB-L\fP|\fB\-\-size\fP [\fB+\fP|\fB-\fP]\fISize\fP[m|UNIT] + \fB-L\fP|\fB--size\fP [\fB+\fP|\fB-\fP]\fISize\fP[m|UNIT] .ad b .br .ad l - \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP + \fB-i\fP|\fB--stripes\fP \fINumber\fP .ad b .br .ad l - \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] + \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] .ad b .br .ad l - \fB-t\fP|\fB\-\-test\fP + \fB-t\fP|\fB--test\fP .ad b .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--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-v\fP|\fB\-\-verbose\fP + \fB-v\fP|\fB--verbose\fP .ad b .br .ad l - \fB\-\-version\fP + \fB--version\fP .ad b .br .ad l - \fB-y\fP|\fB\-\-yes\fP + \fB-y\fP|\fB--yes\fP .ad b .SH DESCRIPTION lvresize resizes an LV in the same way as lvextend and lvreduce. See \fBlvextend\fP(8) and \fBlvreduce\fP(8) for more information. -In the usage section below, \fB\-\-size\fP \fISize\fP can be replaced -with \fB\-\-extents\fP \fINumber\fP. See both descriptions +In the usage section below, \fB--size\fP \fISize\fP can be replaced +with \fB--extents\fP \fINumber\fP. See both descriptions the options section. .SH USAGE Resize an LV by a specified size. .br .P -\fBlvresize\fP \fB-L\fP|\fB\-\-size\fP [\fB+\fP|\fB-\fP]\fISize\fP[m|UNIT] \fILV\fP +\fBlvresize\fP \fB-L\fP|\fB--size\fP [\fB+\fP|\fB-\fP]\fISize\fP[m|UNIT] \fILV\fP .br .RS 4 .ad l -[ \fB-l\fP|\fB\-\-extents\fP [\fB+\fP|\fB-\fP]\fINumber\fP[PERCENT] ] +[ \fB-l\fP|\fB--extents\fP [\fB+\fP|\fB-\fP]\fINumber\fP[PERCENT] ] .ad b .br .ad l -[ \fB-r\fP|\fB\-\-resizefs\fP ] +[ \fB-r\fP|\fB--resizefs\fP ] .ad b .br .ad l -[ \fB\-\-poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] ] +[ \fB--poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] ] .ad b .br [ COMMON_OPTIONS ] @@ -154,7 +154,7 @@ Resize an LV by specified PV extents. .br .RS 4 .ad l -[ \fB-r\fP|\fB\-\-resizefs\fP ] +[ \fB-r\fP|\fB--resizefs\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -165,7 +165,7 @@ Resize an LV by specified PV extents. Resize a pool metadata SubLV by a specified size. .br .P -\fBlvresize\fP \fB\-\-poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] \fILV\fP\fI_thinpool\fP +\fBlvresize\fP \fB--poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] \fILV\fP\fI_thinpool\fP .br .RS 4 [ COMMON_OPTIONS ] @@ -180,43 +180,43 @@ Common options for command: . .RS 4 .ad l -[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-f\fP|\fB\-\-force\fP ] +[ \fB-f\fP|\fB--force\fP ] .ad b .br .ad l -[ \fB-n\fP|\fB\-\-nofsck\fP ] +[ \fB-n\fP|\fB--nofsck\fP ] .ad b .br .ad l -[ \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP ] +[ \fB-i\fP|\fB--stripes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] +[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ] .ad b .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 .ad l -[ \fB\-\-nosync\fP ] +[ \fB--nosync\fP ] .ad b .br .ad l -[ \fB\-\-noudevsync\fP ] +[ \fB--noudevsync\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .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--type\fP \fBlinear\fP|\fBstriped\fP|\fBsnapshot\fP|\fBmirror\fP|\fBraid\fP|\fBthin\fP|\fBcache\fP|\fBthin-pool\fP|\fBcache-pool\fP ] .ad b .RE @@ -224,57 +224,57 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .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 .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 @@ -295,21 +295,21 @@ See \fBlvm\fP(8) for more information about allocation. .ad b .HP .ad l -\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP +\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 vgcfgbackup(8) for more information. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -318,24 +318,24 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-l\fP|\fB\-\-extents\fP [\fB+\fP|\fB-\fP]\fINumber\fP[PERCENT] +\fB-l\fP|\fB--extents\fP [\fB+\fP|\fB-\fP]\fINumber\fP[PERCENT] .br Specifies the new size of the LV in logical extents. -The \-\-size and \-\-extents options are alternate methods of specifying size. +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 @@ -355,34 +355,34 @@ from the current size. .ad b .HP .ad l -\fB-f\fP|\fB\-\-force\fP ... +\fB-f\fP|\fB--force\fP ... .br Override various checks, confirmations and protections. Use with extreme caution. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB-n\fP|\fB\-\-nofsck\fP +\fB-n\fP|\fB--nofsck\fP .br Do not perform fsck before resizing filesystem when filesystem -requires it. You may need to use \-\-force to proceed with +requires it. You may need to use --force to proceed with this option. .ad b .HP .ad l -\fB\-\-nosync\fP +\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 @@ -399,7 +399,7 @@ and thus do not support initial synchronization. .ad b .HP .ad l -\fB\-\-noudevsync\fP +\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 @@ -408,7 +408,7 @@ ignore the devices LVM creates. .ad b .HP .ad l -\fB\-\-poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] +\fB--poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] .br Specifies the new size of the pool metadata LV. The plus prefix \fB+\fP can be used, in which case @@ -416,21 +416,21 @@ the value is added to the current size. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -441,16 +441,16 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-r\fP|\fB\-\-resizefs\fP +\fB-r\fP|\fB--resizefs\fP .br Resize underlying filesystem together with the LV using fsadm(8). .ad b .HP .ad l -\fB-L\fP|\fB\-\-size\fP [\fB+\fP|\fB-\fP]\fISize\fP[m|UNIT] +\fB-L\fP|\fB--size\fP [\fB+\fP|\fB-\fP]\fISize\fP[m|UNIT] .br Specifies the new size of the LV. -The \-\-size and \-\-extents options are alternate methods of specifying size. +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. When the plus \fB+\fP or minus \fB-\fP prefix is used, @@ -459,31 +459,31 @@ from the current size. .ad b .HP .ad l -\fB-i\fP|\fB\-\-stripes\fP \fINumber\fP +\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 +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: 4, raid4/5: 3, raid6: 5.) +(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] +\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 +\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 @@ -493,7 +493,7 @@ back metadata it believes has changed but hasn't. .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 +\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. @@ -503,25 +503,25 @@ 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). +(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-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -560,7 +560,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. @@ -569,7 +569,7 @@ For example, LVM_VG_NAME can generally be substituted for a required VG paramete Extend an LV by 16MB using specific physical extents: .br -.B lvresize \-L+16M vg1/lv1 /dev/sda:0\-1 /dev/sdb:0\-1 +.B lvresize -L+16M vg1/lv1 /dev/sda:0-1 /dev/sdb:0-1 .SH SEE ALSO .BR lvm (8) diff --git a/man/lvs.8_pregen b/man/lvs.8_pregen index 3d0d02c76..2ac6f3ffc 100644 --- a/man/lvs.8_pregen +++ b/man/lvs.8_pregen @@ -1,6 +1,6 @@ .TH LVS 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -lvs \- Display information about logical volumes +lvs - Display information about logical volumes . .SH SYNOPSIS \fBlvs\fP @@ -16,111 +16,111 @@ lvs produces formatted output about LVs. .br .RS 4 .ad l -[ \fB-H\fP|\fB\-\-history\fP ] +[ \fB-H\fP|\fB--history\fP ] .ad b .br .ad l -[ \fB-a\fP|\fB\-\-all\fP ] +[ \fB-a\fP|\fB--all\fP ] .ad b .br .ad l -[ \fB-o\fP|\fB\-\-options\fP \fIString\fP ] +[ \fB-o\fP|\fB--options\fP \fIString\fP ] .ad b .br .ad l -[ \fB-P\fP|\fB\-\-partial\fP ] +[ \fB-P\fP|\fB--partial\fP ] .ad b .br .ad l -[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] +[ \fB-S\fP|\fB--select\fP \fIString\fP ] .ad b .br .ad l -[ \fB-O\fP|\fB\-\-sort\fP \fIString\fP ] +[ \fB-O\fP|\fB--sort\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-segments\fP ] +[ \fB--segments\fP ] .ad b .br .ad l -[ \fB\-\-aligned\fP ] +[ \fB--aligned\fP ] .ad b .br .ad l -[ \fB\-\-binary\fP ] +[ \fB--binary\fP ] .ad b .br .ad l -[ \fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ] +[ \fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ] .ad b .br .ad l -[ \fB\-\-foreign\fP ] +[ \fB--foreign\fP ] .ad b .br .ad l -[ \fB\-\-ignorelockingfailure\fP ] +[ \fB--ignorelockingfailure\fP ] .ad b .br .ad l -[ \fB\-\-ignoreskippedcluster\fP ] +[ \fB--ignoreskippedcluster\fP ] .ad b .br .ad l -[ \fB\-\-logonly\fP ] +[ \fB--logonly\fP ] .ad b .br .ad l -[ \fB\-\-nameprefixes\fP ] +[ \fB--nameprefixes\fP ] .ad b .br .ad l -[ \fB\-\-noheadings\fP ] +[ \fB--noheadings\fP ] .ad b .br .ad l -[ \fB\-\-nolocking\fP ] +[ \fB--nolocking\fP ] .ad b .br .ad l -[ \fB\-\-nosuffix\fP ] +[ \fB--nosuffix\fP ] .ad b .br .ad l -[ \fB\-\-readonly\fP ] +[ \fB--readonly\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br .ad l -[ \fB\-\-rows\fP ] +[ \fB--rows\fP ] .ad b .br .ad l -[ \fB\-\-separator\fP \fIString\fP ] +[ \fB--separator\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-shared\fP ] +[ \fB--shared\fP ] .ad b .br .ad l -[ \fB\-\-trustcache\fP ] +[ \fB--trustcache\fP ] .ad b .br .ad l -[ \fB\-\-unbuffered\fP ] +[ \fB--unbuffered\fP ] .ad b .br .ad l -[ \fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ] +[ \fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ] .ad b .br .ad l -[ \fB\-\-unquoted\fP ] +[ \fB--unquoted\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -134,63 +134,63 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-aligned\fP +\fB--aligned\fP .br -Use with \-\-separator to align the output columns +Use with --separator to align the output columns .ad b .HP .ad l -\fB-a\fP|\fB\-\-all\fP +\fB-a\fP|\fB--all\fP .br Show information about internal LVs. These are components of normal LVs, such as mirrors, @@ -198,7 +198,7 @@ which are not independently accessible, e.g. not mountable. .ad b .HP .ad l -\fB\-\-binary\fP +\fB--binary\fP .br Use binary values "0" or "1" instead of descriptive literal values for columns that have exactly two valid values to report (not counting @@ -206,14 +206,14 @@ the "unknown" value which denotes that the value could not be determined). .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -222,40 +222,40 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP +\fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP .br See lvmreport(7). .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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\-\-foreign\fP +\fB--foreign\fP .br Report/display foreign VGs that would otherwise be skipped. See lvmsystemid(7) for more information about foreign VGs. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB-H\fP|\fB\-\-history\fP +\fB-H\fP|\fB--history\fP .br Include historical LVs in the output. (This has no effect unless LVs were removed while @@ -263,61 +263,61 @@ lvm.conf metadata/record_lvs_history was enabled. .ad b .HP .ad l -\fB\-\-ignorelockingfailure\fP +\fB--ignorelockingfailure\fP .br Allows a command to continue with read-only metadata operations after locking failures. .ad b .HP .ad l -\fB\-\-ignoreskippedcluster\fP +\fB--ignoreskippedcluster\fP .br Use to avoid exiting with an non-zero status code if the command is run without clustered locking and clustered VGs are skipped. .ad b .HP .ad l -\fB\-\-logonly\fP +\fB--logonly\fP .br Suppress command report and display only log report. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-nameprefixes\fP +\fB--nameprefixes\fP .br Add an "LVM2_" prefix plus the field name to the output. Useful -with \-\-noheadings to produce a list of field=value pairs that can +with --noheadings to produce a list of field=value pairs that can be used to set environment variables (for example, in udev rules). .ad b .HP .ad l -\fB\-\-noheadings\fP +\fB--noheadings\fP .br Suppress the headings line that is normally the first line of output. Useful if grepping the output. .ad b .HP .ad l -\fB\-\-nolocking\fP +\fB--nolocking\fP .br Disable locking. .ad b .HP .ad l -\fB\-\-nosuffix\fP +\fB--nosuffix\fP .br -Suppress the suffix on output sizes. Use with \-\-units +Suppress the suffix on output sizes. Use with --units (except h and H) if processing the output. .ad b .HP .ad l -\fB-o\fP|\fB\-\-options\fP \fIString\fP +\fB-o\fP|\fB--options\fP \fIString\fP .br Comma-separated, ordered list of fields to display in columns. String arg syntax is: [+|-|#]Field1[,Field2 ...] @@ -339,7 +339,7 @@ See lvmreport(7) for more information about reporting. .ad b .HP .ad l -\fB-P\fP|\fB\-\-partial\fP +\fB-P\fP|\fB--partial\fP .br When set, the tools will do their best to provide access to VGs that are only partially available (one or more PVs belonging @@ -348,21 +348,21 @@ changed with this option. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-readonly\fP +\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 @@ -376,7 +376,7 @@ actually in use. .ad b .HP .ad l -\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -387,24 +387,24 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB\-\-rows\fP +\fB--rows\fP .br Output columns as rows. .ad b .HP .ad l -\fB\-\-segments\fP +\fB--segments\fP .br Use default columns that emphasize segment information. .ad b .HP .ad l -\fB-S\fP|\fB\-\-select\fP \fIString\fP +\fB-S\fP|\fB--select\fP \fIString\fP .br Select objects for processing and reporting based on specified criteria. -The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). +The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7). For reporting commands, one row is displayed for each object matching the criteria. -See \fB\-\-options help\fP for selectable object fields. +See \fB--options help\fP for selectable object fields. Rows can be displayed with an additional "selected" field (-o selected) showing 1 if the row matches the selection and 0 otherwise. For non-reporting commands which process LVM entities, the selection is @@ -412,13 +412,13 @@ used to choose items to process. .ad b .HP .ad l -\fB\-\-separator\fP \fIString\fP +\fB--separator\fP \fIString\fP .br String to use to separate each column. Useful if grepping the output. .ad b .HP .ad l -\fB\-\-shared\fP +\fB--shared\fP .br Report/display shared VGs that would otherwise be skipped when lvmlockd is not being used on the host. @@ -426,14 +426,14 @@ See lvmlockd(8) for more information about shared VGs. .ad b .HP .ad l -\fB-O\fP|\fB\-\-sort\fP \fIString\fP +\fB-O\fP|\fB--sort\fP \fIString\fP .br Comma-separated ordered list of columns to sort by. Replaces the default selection. Precede any column with \fB-\fP for a reverse sort on that column. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -443,50 +443,50 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB\-\-trustcache\fP +\fB--trustcache\fP .br Avoids certain device scanning during command processing. Do not use. .ad b .HP .ad l -\fB\-\-unbuffered\fP +\fB--unbuffered\fP .br Produce output immediately without sorting or aligning the columns properly. .ad b .HP .ad l -\fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP +\fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP .br All sizes are output in these units: human-(r)eadable with '<' rounding indicator, (h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes. Capitalise to use multiples of 1000 (S.I.) instead of 1024. -Custom units can be specified, e.g. \-\-units 3M. +Custom units can be specified, e.g. --units 3M. .ad b .HP .ad l -\fB\-\-unquoted\fP +\fB--unquoted\fP .br -When used with \-\-nameprefixes, output values in the field=value +When used with --nameprefixes, output values in the field=value pairs are not quoted. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -522,7 +522,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/lvscan.8_pregen b/man/lvscan.8_pregen index 74c43c0b0..a2c32a062 100644 --- a/man/lvscan.8_pregen +++ b/man/lvscan.8_pregen @@ -1,6 +1,6 @@ .TH LVSCAN 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -lvscan \- List all logical volumes in all volume groups +lvscan - List all logical volumes in all volume groups . .SH SYNOPSIS \fBlvscan\fP \fIoption_args\fP @@ -20,14 +20,14 @@ comprehensive information about LVs. .br .RS 4 .ad l -[ \fB-a\fP|\fB\-\-all\fP ] +[ \fB-a\fP|\fB--all\fP ] .ad b .br [ COMMON_OPTIONS ] .RE .br -\fBlvscan\fP \fB\-\-cache\fP +\fBlvscan\fP \fB--cache\fP .br .RS 4 [ COMMON_OPTIONS ] @@ -41,23 +41,23 @@ Common options for command: . .RS 4 .ad l -[ \fB-b\fP|\fB\-\-blockdevice\fP ] +[ \fB-b\fP|\fB--blockdevice\fP ] .ad b .br .ad l -[ \fB-P\fP|\fB\-\-partial\fP ] +[ \fB-P\fP|\fB--partial\fP ] .ad b .br .ad l -[ \fB\-\-ignorelockingfailure\fP ] +[ \fB--ignorelockingfailure\fP ] .ad b .br .ad l -[ \fB\-\-readonly\fP ] +[ \fB--readonly\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .RE @@ -65,57 +65,57 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB-a\fP|\fB\-\-all\fP +\fB-a\fP|\fB--all\fP .br Show information about internal LVs. These are components of normal LVs, such as mirrors, @@ -123,26 +123,26 @@ which are not independently accessible, e.g. not mountable. .ad b .HP .ad l -\fB-b\fP|\fB\-\-blockdevice\fP +\fB-b\fP|\fB--blockdevice\fP .br No longer used. .ad b .HP .ad l -\fB\-\-cache\fP +\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 +\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\-\-config\fP \fIString\fP +\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, @@ -151,40 +151,40 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-ignorelockingfailure\fP +\fB--ignorelockingfailure\fP .br Allows a command to continue with read-only metadata operations after locking failures. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB-P\fP|\fB\-\-partial\fP +\fB-P\fP|\fB--partial\fP .br When set, the tools will do their best to provide access to VGs that are only partially available (one or more PVs belonging @@ -193,21 +193,21 @@ changed with this option. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-readonly\fP +\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 @@ -221,7 +221,7 @@ actually in use. .ad b .HP .ad l -\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -232,7 +232,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -242,20 +242,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -282,7 +282,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/pvchange.8_pregen b/man/pvchange.8_pregen index ba7e7ca63..62f909f8e 100644 --- a/man/pvchange.8_pregen +++ b/man/pvchange.8_pregen @@ -1,6 +1,6 @@ .TH PVCHANGE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -pvchange \- Change attributes of physical volume(s) +pvchange - Change attributes of physical volume(s) . .SH SYNOPSIS \fBpvchange\fP \fIoption_args\fP \fIposition_args\fP @@ -15,27 +15,27 @@ Change properties of all PVs. .P \fBpvchange\fP .RS 4 -( \fB-x\fP|\fB\-\-allocatable\fP \fBy\fP|\fBn\fP, +( \fB-x\fP|\fB--allocatable\fP \fBy\fP|\fBn\fP, .ad b .br .ad l - \fB-u\fP|\fB\-\-uuid\fP, + \fB-u\fP|\fB--uuid\fP, .ad b .br .ad l - \fB-a\fP|\fB\-\-all\fP, + \fB-a\fP|\fB--all\fP, .ad b .br .ad l - \fB\-\-addtag\fP \fITag\fP, + \fB--addtag\fP \fITag\fP, .ad b .br .ad l - \fB\-\-deltag\fP \fITag\fP, + \fB--deltag\fP \fITag\fP, .ad b .br .ad l - \fB\-\-metadataignore\fP \fBy\fP|\fBn\fP ) + \fB--metadataignore\fP \fBy\fP|\fBn\fP ) .RE .br .RS 4 @@ -48,23 +48,23 @@ Change properties of specified PVs. .P \fBpvchange\fP .RS 4 -( \fB-x\fP|\fB\-\-allocatable\fP \fBy\fP|\fBn\fP, +( \fB-x\fP|\fB--allocatable\fP \fBy\fP|\fBn\fP, .ad b .br .ad l - \fB-u\fP|\fB\-\-uuid\fP, + \fB-u\fP|\fB--uuid\fP, .ad b .br .ad l - \fB\-\-addtag\fP \fITag\fP, + \fB--addtag\fP \fITag\fP, .ad b .br .ad l - \fB\-\-deltag\fP \fITag\fP, + \fB--deltag\fP \fITag\fP, .ad b .br .ad l - \fB\-\-metadataignore\fP \fBy\fP|\fBn\fP ) + \fB--metadataignore\fP \fBy\fP|\fBn\fP ) .RE .RS 4 \fIPV\fP|\fISelect\fP ... @@ -72,7 +72,7 @@ Change properties of specified PVs. .br .RS 4 .ad l -[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] +[ \fB-S\fP|\fB--select\fP \fIString\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -83,23 +83,23 @@ Common options for command: . .RS 4 .ad l -[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-f\fP|\fB\-\-force\fP ] +[ \fB-f\fP|\fB--force\fP ] .ad b .br .ad l -[ \fB-u\fP|\fB\-\-uuid\fP ] +[ \fB-u\fP|\fB--uuid\fP ] .ad b .br .ad l -[ \fB\-\-ignoreskippedcluster\fP ] +[ \fB--ignoreskippedcluster\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .RE @@ -107,89 +107,89 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-addtag\fP \fITag\fP +\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 lvm(8) for information about tags. .ad b .HP .ad l -\fB-a\fP|\fB\-\-all\fP +\fB-a\fP|\fB--all\fP .br .ad b .HP .ad l -\fB-x\fP|\fB\-\-allocatable\fP \fBy\fP|\fBn\fP +\fB-x\fP|\fB--allocatable\fP \fBy\fP|\fBn\fP .br Enable or disable allocation of physical extents on this PV. .ad b .HP .ad l -\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP +\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 vgcfgbackup(8) for more information. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -198,54 +198,54 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-deltag\fP \fITag\fP +\fB--deltag\fP \fITag\fP .br Deletes a tag from a PV, VG or LV. This option can be repeated to delete multiple tags at once. See lvm(8) for information about tags. .ad b .HP .ad l -\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-f\fP|\fB\-\-force\fP ... +\fB-f\fP|\fB--force\fP ... .br Override various checks, confirmations and protections. Use with extreme caution. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-ignoreskippedcluster\fP +\fB--ignoreskippedcluster\fP .br Use to avoid exiting with an non-zero status code if the command is run without clustered locking and clustered VGs are skipped. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-metadataignore\fP \fBy\fP|\fBn\fP +\fB--metadataignore\fP \fBy\fP|\fBn\fP .br Specifies the metadataignore property of a PV. If yes, metadata areas on the PV are ignored, and lvm will @@ -254,21 +254,21 @@ If no, lvm will store metadata on the PV. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -279,12 +279,12 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-S\fP|\fB\-\-select\fP \fIString\fP +\fB-S\fP|\fB--select\fP \fIString\fP .br Select objects for processing and reporting based on specified criteria. -The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). +The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7). For reporting commands, one row is displayed for each object matching the criteria. -See \fB\-\-options help\fP for selectable object fields. +See \fB--options help\fP for selectable object fields. Rows can be displayed with an additional "selected" field (-o selected) showing 1 if the row matches the selection and 0 otherwise. For non-reporting commands which process LVM entities, the selection is @@ -292,7 +292,7 @@ used to choose items to process. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -302,26 +302,26 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-u\fP|\fB\-\-uuid\fP +\fB-u\fP|\fB--uuid\fP .br Generate new random UUID for specified PVs. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -342,7 +342,7 @@ Start and length range (counting from 0): \fIPV\fP[\fB:\fP\fIPE\fP\fB+\fP\fIPE\f \fISelect\fP .br Select indicates that a required positional parameter can -be omitted if the \fB\-\-select\fP option is used. +be omitted if the \fB--select\fP option is used. No arg appears in this position. .HP \fIString\fP @@ -359,7 +359,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. @@ -369,7 +369,7 @@ For example, LVM_VG_NAME can generally be substituted for a required VG paramete Disallow the allocation of physical extents on a PV (e.g. because of disk errors, or because it will be removed after freeing it). .br -.B pvchange \-x n /dev/sdk1 +.B pvchange -x n /dev/sdk1 .SH SEE ALSO .BR lvm (8) diff --git a/man/pvck.8_pregen b/man/pvck.8_pregen index f368a092a..0d7924cd8 100644 --- a/man/pvck.8_pregen +++ b/man/pvck.8_pregen @@ -1,6 +1,6 @@ .TH PVCK 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -pvck \- Check the consistency of physical volume(s) +pvck - Check the consistency of physical volume(s) . .SH SYNOPSIS \fBpvck\fP \fIposition_args\fP @@ -14,7 +14,7 @@ pvck checks the LVM metadata for consistency on PVs. .br .RS 4 .ad l -[ \fB\-\-labelsector\fP \fINumber\fP ] +[ \fB--labelsector\fP \fINumber\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -25,64 +25,64 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -91,27 +91,27 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-labelsector\fP \fINumber\fP +\fB--labelsector\fP \fINumber\fP .br By default the PV is labelled with an LVM2 identifier in its second sector (sector 1). This lets you use a different sector near the @@ -120,27 +120,27 @@ in the source). Use with care. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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-t\fP|\fB\-\-test\fP +\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 @@ -150,20 +150,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -195,7 +195,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. @@ -204,10 +204,10 @@ For example, LVM_VG_NAME can generally be substituted for a required VG paramete If the partition table is corrupted or lost on /dev/sda, and you suspect there was an LVM partition at approximately 100 MiB, then this -area of the disk can be scanned using the \fB\-\-labelsector\fP +area of the disk can be scanned using the \fB--labelsector\fP parameter with a value of 204800 (100 * 1024 * 1024 / 512 = 204800). .br -.B pvck \-\-labelsector 204800 /dev/sda +.B pvck --labelsector 204800 /dev/sda .SH SEE ALSO .BR lvm (8) diff --git a/man/pvcreate.8_pregen b/man/pvcreate.8_pregen index 9eb62df48..55d153fef 100644 --- a/man/pvcreate.8_pregen +++ b/man/pvcreate.8_pregen @@ -1,6 +1,6 @@ .TH PVCREATE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -pvcreate \- Initialize physical volume(s) for use by LVM +pvcreate - Initialize physical volume(s) for use by LVM . .SH SYNOPSIS \fBpvcreate\fP \fIposition_args\fP @@ -34,63 +34,63 @@ normally prevent it, e.g. if the PV is already in a VG. .br .RS 4 .ad l -[ \fB-f\fP|\fB\-\-force\fP ] +[ \fB-f\fP|\fB--force\fP ] .ad b .br .ad l -[ \fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ] +[ \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ] .ad b .br .ad l -[ \fB-u\fP|\fB\-\-uuid\fP \fIString\fP ] +[ \fB-u\fP|\fB--uuid\fP \fIString\fP ] .ad b .br .ad l -[ \fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP ] +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-dataalignment\fP \fISize\fP[k|UNIT] ] +[ \fB--dataalignment\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-dataalignmentoffset\fP \fISize\fP[k|UNIT] ] +[ \fB--dataalignmentoffset\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-bootloaderareasize\fP \fISize\fP[m|UNIT] ] +[ \fB--bootloaderareasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-labelsector\fP \fINumber\fP ] +[ \fB--labelsector\fP \fINumber\fP ] .ad b .br .ad l -[ \fB\-\-[pv]metadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP ] +[ \fB--[pv]metadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP ] .ad b .br .ad l -[ \fB\-\-metadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--metadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-metadataignore\fP \fBy\fP|\fBn\fP ] +[ \fB--metadataignore\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-norestorefile\fP ] +[ \fB--norestorefile\fP ] .ad b .br .ad l -[ \fB\-\-setphysicalvolumesize\fP \fISize\fP[m|UNIT] ] +[ \fB--setphysicalvolumesize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br .ad l -[ \fB\-\-restorefile\fP \fIString\fP ] +[ \fB--restorefile\fP \fIString\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -101,78 +101,78 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-bootloaderareasize\fP \fISize\fP[m|UNIT] +\fB--bootloaderareasize\fP \fISize\fP[m|UNIT] .br Create a separate bootloader area of specified size besides PV's data area. The bootloader area is an area of reserved space on the PV from which LVM will not allocate any extents and it's kept untouched. This is primarily aimed for use with bootloaders to embed their own data or metadata. -The start of the bootloader area is always aligned, see also \-\-dataalignment -and \-\-dataalignmentoffset. The bootloader area size may eventually +The start of the bootloader area is always aligned, see also --dataalignment +and --dataalignmentoffset. The bootloader area size may eventually end up increased due to the alignment, but it's never less than the size that is requested. To see the bootloader area start and size of an existing PV use pvs -o +pv_ba_start,pv_ba_size. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -181,50 +181,50 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB\-\-dataalignment\fP \fISize\fP[k|UNIT] +\fB--dataalignment\fP \fISize\fP[k|UNIT] .br Align the start of the data to a multiple of this number. Also specify an appropriate Physical Extent size when creating a VG. To see the location of the first Physical Extent of an existing PV, use pvs -o +pe_start. In addition, it may be shifted by an alignment offset. -See lvm.conf/data_alignment_offset_detection and \-\-dataalignmentoffset. +See lvm.conf/data_alignment_offset_detection and --dataalignmentoffset. .ad b .HP .ad l -\fB\-\-dataalignmentoffset\fP \fISize\fP[k|UNIT] +\fB--dataalignmentoffset\fP \fISize\fP[k|UNIT] .br Shift the start of the data area by this additional offset. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-f\fP|\fB\-\-force\fP ... +\fB-f\fP|\fB--force\fP ... .br Override various checks, confirmations and protections. Use with extreme caution. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-labelsector\fP \fINumber\fP +\fB--labelsector\fP \fINumber\fP .br By default the PV is labelled with an LVM2 identifier in its second sector (sector 1). This lets you use a different sector near the @@ -233,13 +233,13 @@ in the source). Use with care. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-metadataignore\fP \fBy\fP|\fBn\fP +\fB--metadataignore\fP \fBy\fP|\fBn\fP .br Specifies the metadataignore property of a PV. If yes, metadata areas on the PV are ignored, and lvm will @@ -248,14 +248,14 @@ If no, lvm will store metadata on the PV. .ad b .HP .ad l -\fB\-\-metadatasize\fP \fISize\fP[m|UNIT] +\fB--metadatasize\fP \fISize\fP[m|UNIT] .br The approximate amount of space used for each VG metadata area. The size may be rounded. .ad b .HP .ad l -\fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP +\fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP .br Specifies the type of on-disk metadata to use. \fBlvm2\fP (or just \fB2\fP) is the current, standard format. @@ -264,21 +264,21 @@ can be used for accessing old data. .ad b .HP .ad l -\fB\-\-norestorefile\fP +\fB--norestorefile\fP .br -In conjunction with \-\-uuid, this allows a uuid to be specified +In conjunction with --uuid, this allows a uuid to be specified without also requiring that a backup of the metadata be provided. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB\-\-[pv]metadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP +\fB--[pv]metadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP .br The number of metadata areas to set aside on a PV for storing VG metadata. When 2, one copy of the VG metadata is stored at the front of the PV @@ -291,14 +291,14 @@ on the ability to use vgsplit later.) .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -309,9 +309,9 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB\-\-restorefile\fP \fIString\fP +\fB--restorefile\fP \fIString\fP .br -In conjunction with \-\-uuid, this reads the file (produced by +In conjunction with --uuid, this reads the file (produced by vgcfgbackup), extracts the location and size of the data on the PV, and ensures that the metadata produced by the program is consistent with the contents of the file, i.e. the physical extents will be in @@ -321,14 +321,14 @@ areas. Use with care. .ad b .HP .ad l -\fB\-\-setphysicalvolumesize\fP \fISize\fP[m|UNIT] +\fB--setphysicalvolumesize\fP \fISize\fP[m|UNIT] .br Overrides the automatically detected size of the PV. Use with care, or prior to reducing the physical size of the device. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -338,33 +338,33 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-u\fP|\fB\-\-uuid\fP \fIString\fP +\fB-u\fP|\fB--uuid\fP \fIString\fP .br Specify a UUID for the device. Without this option, a random UUID is generated. This option is needed before restoring a backup of LVM metadata onto a replacement device; see vgcfgrestore(8). As such, use of -\-\-restorefile is compulsory unless the \-\-norestorefile is used. +--restorefile is compulsory unless the --norestorefile is used. All PVs must have unique UUIDs, and LVM will prevent certain operations if multiple devices are seen with the same UUID. See vgimportclone(8) for more information. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -372,11 +372,11 @@ answer yes. Use with extreme caution. .ad b .HP .ad l -\fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP +\fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP .br Controls if the first 4 sectors (2048 bytes) of the device are wiped. The default is to wipe these sectors unless either or both of -\-\-restorefile or \-\-uuid are specified. +--restorefile or --uuid are specified. .ad b .SH VARIABLES .HP @@ -404,7 +404,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. @@ -420,7 +420,7 @@ partitioning (sector 7 is the lowest aligned logical block, the 4KiB sectors start at LBA -1, and consequently sector 63 is aligned on a 4KiB boundary) manually account for this when initializing for use by LVM. .br -.B pvcreate \-\-dataalignmentoffset 7s /dev/sdb +.B pvcreate --dataalignmentoffset 7s /dev/sdb .SH SEE ALSO .BR lvm (8) diff --git a/man/pvdisplay.8_pregen b/man/pvdisplay.8_pregen index efb636ad4..94d6ebfb0 100644 --- a/man/pvdisplay.8_pregen +++ b/man/pvdisplay.8_pregen @@ -1,6 +1,6 @@ .TH PVDISPLAY 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -pvdisplay \- Display various attributes of physical volume(s) +pvdisplay - Display various attributes of physical volume(s) . .SH SYNOPSIS \fBpvdisplay\fP @@ -20,95 +20,95 @@ and more, using a more compact and configurable output format. .br .RS 4 .ad l -[ \fB-a\fP|\fB\-\-all\fP ] +[ \fB-a\fP|\fB--all\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB\-\-colon\fP ] +[ \fB-c\fP|\fB--colon\fP ] .ad b .br .ad l -[ \fB-C\fP|\fB\-\-columns\fP ] +[ \fB-C\fP|\fB--columns\fP ] .ad b .br .ad l -[ \fB-m\fP|\fB\-\-maps\fP ] +[ \fB-m\fP|\fB--maps\fP ] .ad b .br .ad l -[ \fB-o\fP|\fB\-\-options\fP \fIString\fP ] +[ \fB-o\fP|\fB--options\fP \fIString\fP ] .ad b .br .ad l -[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] +[ \fB-S\fP|\fB--select\fP \fIString\fP ] .ad b .br .ad l -[ \fB-s\fP|\fB\-\-short\fP ] +[ \fB-s\fP|\fB--short\fP ] .ad b .br .ad l -[ \fB-O\fP|\fB\-\-sort\fP \fIString\fP ] +[ \fB-O\fP|\fB--sort\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-aligned\fP ] +[ \fB--aligned\fP ] .ad b .br .ad l -[ \fB\-\-binary\fP ] +[ \fB--binary\fP ] .ad b .br .ad l -[ \fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ] +[ \fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ] .ad b .br .ad l -[ \fB\-\-foreign\fP ] +[ \fB--foreign\fP ] .ad b .br .ad l -[ \fB\-\-ignorelockingfailure\fP ] +[ \fB--ignorelockingfailure\fP ] .ad b .br .ad l -[ \fB\-\-ignoreskippedcluster\fP ] +[ \fB--ignoreskippedcluster\fP ] .ad b .br .ad l -[ \fB\-\-logonly\fP ] +[ \fB--logonly\fP ] .ad b .br .ad l -[ \fB\-\-noheadings\fP ] +[ \fB--noheadings\fP ] .ad b .br .ad l -[ \fB\-\-nosuffix\fP ] +[ \fB--nosuffix\fP ] .ad b .br .ad l -[ \fB\-\-readonly\fP ] +[ \fB--readonly\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br .ad l -[ \fB\-\-separator\fP \fIString\fP ] +[ \fB--separator\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-shared\fP ] +[ \fB--shared\fP ] .ad b .br .ad l -[ \fB\-\-unbuffered\fP ] +[ \fB--unbuffered\fP ] .ad b .br .ad l -[ \fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ] +[ \fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -122,70 +122,70 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-aligned\fP +\fB--aligned\fP .br -Use with \-\-separator to align the output columns +Use with --separator to align the output columns .ad b .HP .ad l -\fB-a\fP|\fB\-\-all\fP +\fB-a\fP|\fB--all\fP .br Show information about devices that have not been initialized by LVM, i.e. they are not PVs. .ad b .HP .ad l -\fB\-\-binary\fP +\fB--binary\fP .br Use binary values "0" or "1" instead of descriptive literal values for columns that have exactly two valid values to report (not counting @@ -193,28 +193,28 @@ the "unknown" value which denotes that the value could not be determined). .ad b .HP .ad l -\fB-c\fP|\fB\-\-colon\fP +\fB-c\fP|\fB--colon\fP .br Generate colon separated output for easier parsing in scripts or programs. Also see vgs(8) which provides considerably more control over the output. .ad b .HP .ad l -\fB-C\fP|\fB\-\-columns\fP +\fB-C\fP|\fB--columns\fP .br Display output in columns, the equivalent of vgs(8). Options listed are the same as options given in vgs(8). .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -223,86 +223,86 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP +\fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP .br See lvmreport(7). .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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\-\-foreign\fP +\fB--foreign\fP .br Report/display foreign VGs that would otherwise be skipped. See lvmsystemid(7) for more information about foreign VGs. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-ignorelockingfailure\fP +\fB--ignorelockingfailure\fP .br Allows a command to continue with read-only metadata operations after locking failures. .ad b .HP .ad l -\fB\-\-ignoreskippedcluster\fP +\fB--ignoreskippedcluster\fP .br Use to avoid exiting with an non-zero status code if the command is run without clustered locking and clustered VGs are skipped. .ad b .HP .ad l -\fB\-\-logonly\fP +\fB--logonly\fP .br Suppress command report and display only log report. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB-m\fP|\fB\-\-maps\fP +\fB-m\fP|\fB--maps\fP .br Display the mapping of physical extents to LVs and logical extents. .ad b .HP .ad l -\fB\-\-noheadings\fP +\fB--noheadings\fP .br Suppress the headings line that is normally the first line of output. Useful if grepping the output. .ad b .HP .ad l -\fB\-\-nosuffix\fP +\fB--nosuffix\fP .br -Suppress the suffix on output sizes. Use with \-\-units +Suppress the suffix on output sizes. Use with --units (except h and H) if processing the output. .ad b .HP .ad l -\fB-o\fP|\fB\-\-options\fP \fIString\fP +\fB-o\fP|\fB--options\fP \fIString\fP .br Comma-separated, ordered list of fields to display in columns. String arg syntax is: [+|-|#]Field1[,Field2 ...] @@ -324,21 +324,21 @@ See lvmreport(7) for more information about reporting. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-readonly\fP +\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 @@ -352,7 +352,7 @@ actually in use. .ad b .HP .ad l -\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -363,12 +363,12 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-S\fP|\fB\-\-select\fP \fIString\fP +\fB-S\fP|\fB--select\fP \fIString\fP .br Select objects for processing and reporting based on specified criteria. -The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). +The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7). For reporting commands, one row is displayed for each object matching the criteria. -See \fB\-\-options help\fP for selectable object fields. +See \fB--options help\fP for selectable object fields. Rows can be displayed with an additional "selected" field (-o selected) showing 1 if the row matches the selection and 0 otherwise. For non-reporting commands which process LVM entities, the selection is @@ -376,13 +376,13 @@ used to choose items to process. .ad b .HP .ad l -\fB\-\-separator\fP \fIString\fP +\fB--separator\fP \fIString\fP .br String to use to separate each column. Useful if grepping the output. .ad b .HP .ad l -\fB\-\-shared\fP +\fB--shared\fP .br Report/display shared VGs that would otherwise be skipped when lvmlockd is not being used on the host. @@ -390,20 +390,20 @@ See lvmlockd(8) for more information about shared VGs. .ad b .HP .ad l -\fB-s\fP|\fB\-\-short\fP +\fB-s\fP|\fB--short\fP .br Only display the size of the given PVs. .ad b .HP .ad l -\fB-O\fP|\fB\-\-sort\fP \fIString\fP +\fB-O\fP|\fB--sort\fP \fIString\fP .br Comma-separated ordered list of columns to sort by. Replaces the default selection. Precede any column with \fB-\fP for a reverse sort on that column. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -413,37 +413,37 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB\-\-unbuffered\fP +\fB--unbuffered\fP .br Produce output immediately without sorting or aligning the columns properly. .ad b .HP .ad l -\fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP +\fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP .br All sizes are output in these units: human-(r)eadable with '<' rounding indicator, (h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes. Capitalise to use multiples of 1000 (S.I.) instead of 1024. -Custom units can be specified, e.g. \-\-units 3M. +Custom units can be specified, e.g. --units 3M. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -480,7 +480,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/pvmove.8_pregen b/man/pvmove.8_pregen index f8a8b5ce9..e6aa48f99 100644 --- a/man/pvmove.8_pregen +++ b/man/pvmove.8_pregen @@ -1,6 +1,6 @@ .TH PVMOVE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -pvmove \- Move extents from one physical volume to another +pvmove - Move extents from one physical volume to another . .SH SYNOPSIS \fBpvmove\fP \fIposition_args\fP @@ -33,27 +33,27 @@ Move PV extents. .br .RS 4 .ad l -[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-n\fP|\fB\-\-name\fP \fILV\fP ] +[ \fB-n\fP|\fB--name\fP \fILV\fP ] .ad b .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 .ad l -[ \fB\-\-atomic\fP ] +[ \fB--atomic\fP ] .ad b .br .ad l -[ \fB\-\-noudevsync\fP ] +[ \fB--noudevsync\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -77,15 +77,15 @@ Common options for command: . .RS 4 .ad l -[ \fB-b\fP|\fB\-\-background\fP ] +[ \fB-b\fP|\fB--background\fP ] .ad b .br .ad l -[ \fB-i\fP|\fB\-\-interval\fP \fINumber\fP ] +[ \fB-i\fP|\fB--interval\fP \fINumber\fP ] .ad b .br .ad l -[ \fB\-\-abort\fP ] +[ \fB--abort\fP ] .ad b .RE @@ -93,66 +93,66 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-abort\fP +\fB--abort\fP .br Abort any pvmove operations in progress. If a pvmove was started -with the \-\-atomic option, then all LVs will remain on the source PV. +with the --atomic option, then all LVs will remain on the source PV. Otherwise, segments that have been moved will remain on the destination PV, while unmoved segments will remain on the source PV. .ad b .HP .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 .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 @@ -173,21 +173,21 @@ See \fBlvm\fP(8) for more information about allocation. .ad b .HP .ad l -\fB\-\-atomic\fP +\fB--atomic\fP .br Makes a pvmove operation atomic, ensuring that all affected LVs are moved to the destination PV, or none are if the operation is aborted. .ad b .HP .ad l -\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP +\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 vgcfgbackup(8) for more information. .ad b .HP .ad l -\fB-b\fP|\fB\-\-background\fP +\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 @@ -195,14 +195,14 @@ background. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -211,45 +211,45 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB-i\fP|\fB\-\-interval\fP \fINumber\fP +\fB-i\fP|\fB--interval\fP \fINumber\fP .br Report progress at regular intervals. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB-n\fP|\fB\-\-name\fP \fIString\fP +\fB-n\fP|\fB--name\fP \fIString\fP .br Move only the extents belonging to the named LV. .ad b .HP .ad l -\fB\-\-noudevsync\fP +\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 @@ -258,21 +258,21 @@ ignore the devices LVM creates. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -283,7 +283,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -293,20 +293,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -338,7 +338,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. @@ -378,7 +378,7 @@ Note that this new process cannot support the original LVM1 type of on-disk metadata. Metadata can be converted using \fBvgconvert\fP(8). -If the \fB\-\-atomic\fP option is used, a slightly different approach is +If the \fB--atomic\fP option is used, a slightly different approach is used for the move. Again, a temporary 'pvmove' LV is created to store the details of all the data movements required. This temporary LV contains all the segments of the various LVs that need to be moved. However, in @@ -402,13 +402,13 @@ Use a specific destination PV when moving physical extents. Move extents belonging to a single LV. .br -.B pvmove \-n lvol1 /dev/sdb1 /dev/sdc1 +.B pvmove -n lvol1 /dev/sdb1 /dev/sdc1 Rather than moving the contents of an entire device, it is possible to move a range of physical extents, for example numbers 1000 to 1999 inclusive on the specified PV. .br -.B pvmove /dev/sdb1:1000\-1999 +.B pvmove /dev/sdb1:1000-1999 A range of physical extents to move can be specified as start+length. For example, starting from PE 1000. (Counting starts from 0, so this refers to the @@ -419,21 +419,21 @@ example, starting from PE 1000. (Counting starts from 0, so this refers to the Move a range of physical extents to a specific PV (which must have sufficient free extents). .br -.B pvmove /dev/sdb1:1000\-1999 /dev/sdc1 +.B pvmove /dev/sdb1:1000-1999 /dev/sdc1 Move a range of physical extents to specific new extents on a new PV. .br -.B pvmove /dev/sdb1:1000\-1999 /dev/sdc1:0\-999 +.B pvmove /dev/sdb1:1000-1999 /dev/sdc1:0-999 If the source and destination are on the same disk, the \fBanywhere\fP allocation policy is needed. .br -.B pvmove \-\-alloc anywhere /dev/sdb1:1000\-1999 /dev/sdb1:0\-999 +.B pvmove --alloc anywhere /dev/sdb1:1000-1999 /dev/sdb1:0-999 The part of a specific LV present within in a range of physical extents can also be picked out and moved. .br -.B pvmove \-n lvol1 /dev/sdb1:1000\-1999 /dev/sdc1 +.B pvmove -n lvol1 /dev/sdb1:1000-1999 /dev/sdc1 .SH SEE ALSO .BR lvm (8) diff --git a/man/pvremove.8_pregen b/man/pvremove.8_pregen index aca7c6bff..57b28cf47 100644 --- a/man/pvremove.8_pregen +++ b/man/pvremove.8_pregen @@ -1,6 +1,6 @@ .TH PVREMOVE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -pvremove \- Remove LVM label(s) from physical volume(s) +pvremove - Remove LVM label(s) from physical volume(s) . .SH SYNOPSIS \fBpvremove\fP \fIposition_args\fP @@ -20,11 +20,11 @@ an existing VG. Normally, \fBvgreduce\fP(8) should be used instead. .br .RS 4 .ad l -[ \fB-f\fP|\fB\-\-force\fP ] +[ \fB-f\fP|\fB--force\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -35,64 +35,64 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -101,54 +101,54 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-f\fP|\fB\-\-force\fP ... +\fB-f\fP|\fB--force\fP ... .br Override various checks, confirmations and protections. Use with extreme caution. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -159,7 +159,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -169,20 +169,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -214,7 +214,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/pvresize.8_pregen b/man/pvresize.8_pregen index 6a8f496cf..1b37c727a 100644 --- a/man/pvresize.8_pregen +++ b/man/pvresize.8_pregen @@ -1,6 +1,6 @@ .TH PVRESIZE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -pvresize \- Resize physical volume(s) +pvresize - Resize physical volume(s) . .SH SYNOPSIS \fBpvresize\fP \fIposition_args\fP @@ -15,11 +15,11 @@ LVs allocated on it. .br .RS 4 .ad l -[ \fB\-\-setphysicalvolumesize\fP \fISize\fP[m|UNIT] ] +[ \fB--setphysicalvolumesize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -30,64 +30,64 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -96,47 +96,47 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -147,14 +147,14 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB\-\-setphysicalvolumesize\fP \fISize\fP[m|UNIT] +\fB--setphysicalvolumesize\fP \fISize\fP[m|UNIT] .br Overrides the automatically detected size of the PV. Use with care, or prior to reducing the physical size of the device. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -164,20 +164,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -209,7 +209,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. @@ -225,7 +225,7 @@ Expand a PV after enlarging the partition. Shrink a PV prior to shrinking the partition (ensure that the PV size is appropriate for the intended new partition size). .br -.B pvresize \-\-setphysicalvolumesize 40G /dev/sda1 +.B pvresize --setphysicalvolumesize 40G /dev/sda1 .SH SEE ALSO .BR lvm (8) diff --git a/man/pvs.8_pregen b/man/pvs.8_pregen index b9b36d601..d6afbb976 100644 --- a/man/pvs.8_pregen +++ b/man/pvs.8_pregen @@ -1,6 +1,6 @@ .TH PVS 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -pvs \- Display information about physical volumes +pvs - Display information about physical volumes . .SH SYNOPSIS \fBpvs\fP @@ -16,107 +16,107 @@ pvs produces formatted output about PVs. .br .RS 4 .ad l -[ \fB-a\fP|\fB\-\-all\fP ] +[ \fB-a\fP|\fB--all\fP ] .ad b .br .ad l -[ \fB-o\fP|\fB\-\-options\fP \fIString\fP ] +[ \fB-o\fP|\fB--options\fP \fIString\fP ] .ad b .br .ad l -[ \fB-P\fP|\fB\-\-partial\fP ] +[ \fB-P\fP|\fB--partial\fP ] .ad b .br .ad l -[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] +[ \fB-S\fP|\fB--select\fP \fIString\fP ] .ad b .br .ad l -[ \fB-O\fP|\fB\-\-sort\fP \fIString\fP ] +[ \fB-O\fP|\fB--sort\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-segments\fP ] +[ \fB--segments\fP ] .ad b .br .ad l -[ \fB\-\-aligned\fP ] +[ \fB--aligned\fP ] .ad b .br .ad l -[ \fB\-\-binary\fP ] +[ \fB--binary\fP ] .ad b .br .ad l -[ \fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ] +[ \fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ] .ad b .br .ad l -[ \fB\-\-foreign\fP ] +[ \fB--foreign\fP ] .ad b .br .ad l -[ \fB\-\-ignorelockingfailure\fP ] +[ \fB--ignorelockingfailure\fP ] .ad b .br .ad l -[ \fB\-\-ignoreskippedcluster\fP ] +[ \fB--ignoreskippedcluster\fP ] .ad b .br .ad l -[ \fB\-\-logonly\fP ] +[ \fB--logonly\fP ] .ad b .br .ad l -[ \fB\-\-nameprefixes\fP ] +[ \fB--nameprefixes\fP ] .ad b .br .ad l -[ \fB\-\-noheadings\fP ] +[ \fB--noheadings\fP ] .ad b .br .ad l -[ \fB\-\-nolocking\fP ] +[ \fB--nolocking\fP ] .ad b .br .ad l -[ \fB\-\-nosuffix\fP ] +[ \fB--nosuffix\fP ] .ad b .br .ad l -[ \fB\-\-readonly\fP ] +[ \fB--readonly\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br .ad l -[ \fB\-\-rows\fP ] +[ \fB--rows\fP ] .ad b .br .ad l -[ \fB\-\-separator\fP \fIString\fP ] +[ \fB--separator\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-shared\fP ] +[ \fB--shared\fP ] .ad b .br .ad l -[ \fB\-\-trustcache\fP ] +[ \fB--trustcache\fP ] .ad b .br .ad l -[ \fB\-\-unbuffered\fP ] +[ \fB--unbuffered\fP ] .ad b .br .ad l -[ \fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ] +[ \fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ] .ad b .br .ad l -[ \fB\-\-unquoted\fP ] +[ \fB--unquoted\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -130,70 +130,70 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-aligned\fP +\fB--aligned\fP .br -Use with \-\-separator to align the output columns +Use with --separator to align the output columns .ad b .HP .ad l -\fB-a\fP|\fB\-\-all\fP +\fB-a\fP|\fB--all\fP .br Show information about devices that have not been initialized by LVM, i.e. they are not PVs. .ad b .HP .ad l -\fB\-\-binary\fP +\fB--binary\fP .br Use binary values "0" or "1" instead of descriptive literal values for columns that have exactly two valid values to report (not counting @@ -201,14 +201,14 @@ the "unknown" value which denotes that the value could not be determined). .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -217,94 +217,94 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP +\fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP .br See lvmreport(7). .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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\-\-foreign\fP +\fB--foreign\fP .br Report/display foreign VGs that would otherwise be skipped. See lvmsystemid(7) for more information about foreign VGs. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-ignorelockingfailure\fP +\fB--ignorelockingfailure\fP .br Allows a command to continue with read-only metadata operations after locking failures. .ad b .HP .ad l -\fB\-\-ignoreskippedcluster\fP +\fB--ignoreskippedcluster\fP .br Use to avoid exiting with an non-zero status code if the command is run without clustered locking and clustered VGs are skipped. .ad b .HP .ad l -\fB\-\-logonly\fP +\fB--logonly\fP .br Suppress command report and display only log report. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-nameprefixes\fP +\fB--nameprefixes\fP .br Add an "LVM2_" prefix plus the field name to the output. Useful -with \-\-noheadings to produce a list of field=value pairs that can +with --noheadings to produce a list of field=value pairs that can be used to set environment variables (for example, in udev rules). .ad b .HP .ad l -\fB\-\-noheadings\fP +\fB--noheadings\fP .br Suppress the headings line that is normally the first line of output. Useful if grepping the output. .ad b .HP .ad l -\fB\-\-nolocking\fP +\fB--nolocking\fP .br Disable locking. .ad b .HP .ad l -\fB\-\-nosuffix\fP +\fB--nosuffix\fP .br -Suppress the suffix on output sizes. Use with \-\-units +Suppress the suffix on output sizes. Use with --units (except h and H) if processing the output. .ad b .HP .ad l -\fB-o\fP|\fB\-\-options\fP \fIString\fP +\fB-o\fP|\fB--options\fP \fIString\fP .br Comma-separated, ordered list of fields to display in columns. String arg syntax is: [+|-|#]Field1[,Field2 ...] @@ -326,7 +326,7 @@ See lvmreport(7) for more information about reporting. .ad b .HP .ad l -\fB-P\fP|\fB\-\-partial\fP +\fB-P\fP|\fB--partial\fP .br When set, the tools will do their best to provide access to VGs that are only partially available (one or more PVs belonging @@ -335,21 +335,21 @@ changed with this option. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-readonly\fP +\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 @@ -363,7 +363,7 @@ actually in use. .ad b .HP .ad l -\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -374,13 +374,13 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB\-\-rows\fP +\fB--rows\fP .br Output columns as rows. .ad b .HP .ad l -\fB\-\-segments\fP +\fB--segments\fP .br Produces one line of output for each contiguous allocation of space on each PV, showing the start (pvseg_start) and length (pvseg_size) in units of @@ -388,12 +388,12 @@ physical extents. .ad b .HP .ad l -\fB-S\fP|\fB\-\-select\fP \fIString\fP +\fB-S\fP|\fB--select\fP \fIString\fP .br Select objects for processing and reporting based on specified criteria. -The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). +The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7). For reporting commands, one row is displayed for each object matching the criteria. -See \fB\-\-options help\fP for selectable object fields. +See \fB--options help\fP for selectable object fields. Rows can be displayed with an additional "selected" field (-o selected) showing 1 if the row matches the selection and 0 otherwise. For non-reporting commands which process LVM entities, the selection is @@ -401,13 +401,13 @@ used to choose items to process. .ad b .HP .ad l -\fB\-\-separator\fP \fIString\fP +\fB--separator\fP \fIString\fP .br String to use to separate each column. Useful if grepping the output. .ad b .HP .ad l -\fB\-\-shared\fP +\fB--shared\fP .br Report/display shared VGs that would otherwise be skipped when lvmlockd is not being used on the host. @@ -415,14 +415,14 @@ See lvmlockd(8) for more information about shared VGs. .ad b .HP .ad l -\fB-O\fP|\fB\-\-sort\fP \fIString\fP +\fB-O\fP|\fB--sort\fP \fIString\fP .br Comma-separated ordered list of columns to sort by. Replaces the default selection. Precede any column with \fB-\fP for a reverse sort on that column. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -432,50 +432,50 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB\-\-trustcache\fP +\fB--trustcache\fP .br Avoids certain device scanning during command processing. Do not use. .ad b .HP .ad l -\fB\-\-unbuffered\fP +\fB--unbuffered\fP .br Produce output immediately without sorting or aligning the columns properly. .ad b .HP .ad l -\fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP +\fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP .br All sizes are output in these units: human-(r)eadable with '<' rounding indicator, (h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes. Capitalise to use multiples of 1000 (S.I.) instead of 1024. -Custom units can be specified, e.g. \-\-units 3M. +Custom units can be specified, e.g. --units 3M. .ad b .HP .ad l -\fB\-\-unquoted\fP +\fB--unquoted\fP .br -When used with \-\-nameprefixes, output values in the field=value +When used with --nameprefixes, output values in the field=value pairs are not quoted. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -512,7 +512,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/pvscan.8_pregen b/man/pvscan.8_pregen index a13d1cd3d..472728c2f 100644 --- a/man/pvscan.8_pregen +++ b/man/pvscan.8_pregen @@ -1,6 +1,6 @@ .TH PVSCAN 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -pvscan \- List all physical volumes +pvscan - List all physical volumes . .SH SYNOPSIS \fBpvscan\fP \fIoption_args\fP @@ -32,25 +32,25 @@ commands. When lvmetad is used, LVM commands avoid scanning disks by reading metadata from lvmetad. When new disks appear, they must be scanned so their metadata can be cached in lvmetad. This is done by the command -pvscan \-\-cache, which scans disks and passes the metadata to lvmetad. +pvscan --cache, which scans disks and passes the metadata to lvmetad. -The pvscan \-\-cache command is typically run automatically by system +The pvscan --cache command is typically run automatically by system services when a new device appears. Users do not generally need to run this command if the system and lvmetad are running properly. Many scripts contain unnecessary pvscan (or vgscan) commands for historical reasons. To avoid disrupting the system with extraneous disk -scanning, an ordinary pvscan (without \-\-cache) will simply read metadata +scanning, an ordinary pvscan (without --cache) will simply read metadata from lvmetad like other LVM commands. It does not do anything beyond displaying the current state of the cache. .IP \[bu] 2 -When given specific device name arguments, pvscan \-\-cache will only +When given specific device name arguments, pvscan --cache will only read the named devices. .IP \[bu] 2 LVM udev rules and systemd services are used to initiate automatic device scanning. .IP \[bu] 2 -To prevent devices from being scanned by pvscan \-\-cache, add them +To prevent devices from being scanned by pvscan --cache, add them to .BR lvm.conf (5) .B devices/global_filter. @@ -58,11 +58,11 @@ The devices/filter setting does not apply to system level scanning. For more information, see: .br -.B lvmconfig \-\-withcomments devices/global_filter +.B lvmconfig --withcomments devices/global_filter .IP \[bu] 2 If lvmetad is started or restarted after devices are visible, or if the global_filter has changed, then all devices must be rescanned -for metadata with the command pvscan \-\-cache. +for metadata with the command pvscan --cache. .IP \[bu] 2 lvmetad does not cache older metadata formats, e.g. lvm1, and will be temporarily disabled if they are seen. @@ -74,9 +74,9 @@ minor numbers must be given, not the path. When event-driven system services detect a new LVM device, the first step is to automatically scan and cache the metadata from the device. This is -done by pvscan \-\-cache. A second step is to automatically activate LVs +done by pvscan --cache. A second step is to automatically activate LVs that are present on the new device. This auto-activation is done by the -same pvscan \-\-cache command when the option '\-a|\-\-activate ay' is +same pvscan --cache command when the option '-a|--activate ay' is included. Auto-activation of VGs or LVs can be enabled/disabled using: @@ -86,17 +86,17 @@ Auto-activation of VGs or LVs can be enabled/disabled using: For more information, see: .br -.B lvmconfig \-\-withcomments activation/auto_activation_volume_list +.B lvmconfig --withcomments activation/auto_activation_volume_list When this setting is undefined, all LVs are auto-activated (when lvm is fully integrated with the event-driven system services.) When a VG or LV is not auto-activated, traditional activation using -vgchange or lvchange -a|\-\-activate is needed. +vgchange or lvchange -a|--activate is needed. .IP \[bu] 2 -pvscan auto-activation can be only done in combination with \-\-cache. +pvscan auto-activation can be only done in combination with --cache. .IP \[bu] 2 -Auto-activation is designated by the "a" argument in '-a|\-\-activate ay'. +Auto-activation is designated by the "a" argument in '-a|--activate ay'. This is meant to distinguish system generated commands from explicit user commands, although it can be used in any activation command. Whenever it is used, the auto_activation_volume_list is applied. @@ -111,19 +111,19 @@ Display PV information. .br .RS 4 .ad l -[ \fB-e\fP|\fB\-\-exported\fP ] +[ \fB-e\fP|\fB--exported\fP ] .ad b .br .ad l -[ \fB-n\fP|\fB\-\-novolumegroup\fP ] +[ \fB-n\fP|\fB--novolumegroup\fP ] .ad b .br .ad l -[ \fB-s\fP|\fB\-\-short\fP ] +[ \fB-s\fP|\fB--short\fP ] .ad b .br .ad l -[ \fB-u\fP|\fB\-\-uuid\fP ] +[ \fB-u\fP|\fB--uuid\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -133,23 +133,23 @@ Display PV information. Populate the lvmetad cache by scanning PVs. .br .P -\fBpvscan\fP \fB\-\-cache\fP +\fBpvscan\fP \fB--cache\fP .br .RS 4 .ad l -[ \fB-b\fP|\fB\-\-background\fP ] +[ \fB-b\fP|\fB--background\fP ] .ad b .br .ad l -[ \fB-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] +[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] .ad b .br .ad l -[ \fB-j\fP|\fB\-\-major\fP \fINumber\fP ] +[ \fB-j\fP|\fB--major\fP \fINumber\fP ] .ad b .br .ad l -[ \fB\-\-minor\fP \fINumber\fP ] +[ \fB--minor\fP \fINumber\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -163,11 +163,11 @@ Common options for command: . .RS 4 .ad l -[ \fB\-\-ignorelockingfailure\fP ] +[ \fB--ignorelockingfailure\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .RE @@ -175,62 +175,62 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP +\fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP .br .ad b .HP .ad l -\fB-b\fP|\fB\-\-background\fP +\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 @@ -238,20 +238,20 @@ background. .ad b .HP .ad l -\fB\-\-cache\fP +\fB--cache\fP .br Scan one or more devices and send the metadata to lvmetad. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -260,78 +260,78 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-e\fP|\fB\-\-exported\fP +\fB-e\fP|\fB--exported\fP .br Only show PVs belonging to exported VGs. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-ignorelockingfailure\fP +\fB--ignorelockingfailure\fP .br Allows a command to continue with read-only metadata operations after locking failures. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB-j\fP|\fB\-\-major\fP \fINumber\fP +\fB-j\fP|\fB--major\fP \fINumber\fP .br The major number of a device. .ad b .HP .ad l -\fB\-\-minor\fP \fINumber\fP +\fB--minor\fP \fINumber\fP .br The minor number of a device. .ad b .HP .ad l -\fB-n\fP|\fB\-\-novolumegroup\fP +\fB-n\fP|\fB--novolumegroup\fP .br Only show PVs not belonging to any VG. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -342,13 +342,13 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-s\fP|\fB\-\-short\fP +\fB-s\fP|\fB--short\fP .br Short listing format. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -358,26 +358,26 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-u\fP|\fB\-\-uuid\fP +\fB-u\fP|\fB--uuid\fP .br Show UUIDs in addition to device names. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -409,7 +409,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/vgcfgbackup.8_pregen b/man/vgcfgbackup.8_pregen index 837030d77..b3f41afe8 100644 --- a/man/vgcfgbackup.8_pregen +++ b/man/vgcfgbackup.8_pregen @@ -1,6 +1,6 @@ .TH VGCFGBACKUP 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -vgcfgbackup \- Backup volume group configuration(s) +vgcfgbackup - Backup volume group configuration(s) . .SH SYNOPSIS \fBvgcfgbackup\fP @@ -18,7 +18,7 @@ files. In a default installation, each VG is backed up into a separate file bearing the name of the VG in the directory \fI#DEFAULT_BACKUP_DIR#\fP. -To use an alternative back up file, use \fB\-f\fP. In this case, when +To use an alternative back up file, use \fB-f\fP. In this case, when backing up multiple VGs, the file name is treated as a template, with %s replaced by the VG name. @@ -31,27 +31,27 @@ It may also be useful to regularly back up the files in .br .RS 4 .ad l -[ \fB-f\fP|\fB\-\-file\fP \fIString\fP ] +[ \fB-f\fP|\fB--file\fP \fIString\fP ] .ad b .br .ad l -[ \fB-P\fP|\fB\-\-partial\fP ] +[ \fB-P\fP|\fB--partial\fP ] .ad b .br .ad l -[ \fB\-\-foreign\fP ] +[ \fB--foreign\fP ] .ad b .br .ad l -[ \fB\-\-ignorelockingfailure\fP ] +[ \fB--ignorelockingfailure\fP ] .ad b .br .ad l -[ \fB\-\-readonly\fP ] +[ \fB--readonly\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -65,64 +65,64 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -131,21 +131,21 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-f\fP|\fB\-\-file\fP \fIString\fP +\fB-f\fP|\fB--file\fP \fIString\fP .br Write the backup to the named file. When backing up more than one VG, the file name is @@ -153,33 +153,33 @@ treated as a template, and %s is replaced by the VG name. .ad b .HP .ad l -\fB\-\-foreign\fP +\fB--foreign\fP .br Report/display foreign VGs that would otherwise be skipped. See lvmsystemid(7) for more information about foreign VGs. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-ignorelockingfailure\fP +\fB--ignorelockingfailure\fP .br Allows a command to continue with read-only metadata operations after locking failures. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB-P\fP|\fB\-\-partial\fP +\fB-P\fP|\fB--partial\fP .br When set, the tools will do their best to provide access to VGs that are only partially available (one or more PVs belonging @@ -188,21 +188,21 @@ changed with this option. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-readonly\fP +\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 @@ -216,7 +216,7 @@ actually in use. .ad b .HP .ad l -\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -227,7 +227,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -237,20 +237,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -276,7 +276,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/vgcfgrestore.8_pregen b/man/vgcfgrestore.8_pregen index 72ff2e7ea..5197f1a99 100644 --- a/man/vgcfgrestore.8_pregen +++ b/man/vgcfgrestore.8_pregen @@ -1,6 +1,6 @@ .TH VGCFGRESTORE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -vgcfgrestore \- Restore volume group configuration +vgcfgrestore - Restore volume group configuration . .SH SYNOPSIS \fBvgcfgrestore\fP \fIoption_args\fP \fIposition_args\fP @@ -11,75 +11,75 @@ vgcfgrestore \- Restore volume group configuration .br .P .ad l - \fB\-\-commandprofile\fP \fIString\fP + \fB--commandprofile\fP \fIString\fP .ad b .br .ad l - \fB\-\-config\fP \fIString\fP + \fB--config\fP \fIString\fP .ad b .br .ad l - \fB-d\fP|\fB\-\-debug\fP + \fB-d\fP|\fB--debug\fP .ad b .br .ad l - \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP + \fB--driverloaded\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB-f\fP|\fB\-\-file\fP \fIString\fP + \fB-f\fP|\fB--file\fP \fIString\fP .ad b .br .ad l - \fB\-\-force\fP + \fB--force\fP .ad b .br .ad l - \fB-h\fP|\fB\-\-help\fP + \fB-h\fP|\fB--help\fP .ad b .br .ad l - \fB-l\fP|\fB\-\-list\fP + \fB-l\fP|\fB--list\fP .ad b .br .ad l - \fB\-\-longhelp\fP + \fB--longhelp\fP .ad b .br .ad l - \fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP + \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP .ad b .br .ad l - \fB\-\-profile\fP \fIString\fP + \fB--profile\fP \fIString\fP .ad b .br .ad l - \fB-q\fP|\fB\-\-quiet\fP + \fB-q\fP|\fB--quiet\fP .ad b .br .ad l - \fB-t\fP|\fB\-\-test\fP + \fB-t\fP|\fB--test\fP .ad b .br .ad l - \fB-v\fP|\fB\-\-verbose\fP + \fB-v\fP|\fB--verbose\fP .ad b .br .ad l - \fB\-\-version\fP + \fB--version\fP .ad b .br .ad l - \fB-y\fP|\fB\-\-yes\fP + \fB-y\fP|\fB--yes\fP .ad b .SH DESCRIPTION vgcfgrestore restores the metadata of a VG from a text back up file produced by \fBvgcfgbackup\fP. This writes VG metadata onto the devices specifed in back up file. -A back up file can be specified with \fB\-\-file\fP. If no backup file is -specified, the most recent one is used. Use \fB\-\-list\fP for a list of +A back up file can be specified with \fB--file\fP. If no backup file is +specified, the most recent one is used. Use \fB--list\fP for a list of the available back up and archive files of a VG. WARNING: When a VG contains thin pools, changes to thin metadata cannot be @@ -100,7 +100,7 @@ Restore VG metadata from last backup. Restore VG metadata from specified file. .br .P -\fBvgcfgrestore\fP \fB-f\fP|\fB\-\-file\fP \fIString\fP \fIVG\fP +\fBvgcfgrestore\fP \fB-f\fP|\fB--file\fP \fIString\fP \fIVG\fP .br .RS 4 [ COMMON_OPTIONS ] @@ -111,7 +111,7 @@ Restore VG metadata from specified file. List all VG metadata backups. .br .P -\fBvgcfgrestore\fP \fB-l\fP|\fB\-\-list\fP \fIVG\fP +\fBvgcfgrestore\fP \fB-l\fP|\fB--list\fP \fIVG\fP .br .RS 4 [ COMMON_OPTIONS ] @@ -122,7 +122,7 @@ List all VG metadata backups. List one VG metadata backup file. .br .P -\fBvgcfgrestore\fP \fB-l\fP|\fB\-\-list\fP \fB-f\fP|\fB\-\-file\fP \fIString\fP +\fBvgcfgrestore\fP \fB-l\fP|\fB--list\fP \fB-f\fP|\fB--file\fP \fIString\fP .br .RS 4 [ COMMON_OPTIONS ] @@ -137,11 +137,11 @@ Common options for command: . .RS 4 .ad l -[ \fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ] +[ \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ] .ad b .br .ad l -[ \fB\-\-force\fP ] +[ \fB--force\fP ] .ad b .RE @@ -149,64 +149,64 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -215,28 +215,28 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-f\fP|\fB\-\-file\fP \fIString\fP +\fB-f\fP|\fB--file\fP \fIString\fP .br Read metadata backup from the named file. Usually this file was created by vgcfgbackup. .ad b .HP .ad l -\fB\-\-force\fP ... +\fB--force\fP ... .br Force metadata restore even with thin pool LVs. Use with extreme caution. Most changes to thin metadata @@ -246,26 +246,26 @@ thin pool kernel metadata precisely. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB-l\fP|\fB\-\-list\fP +\fB-l\fP|\fB--list\fP .br List metadata backup and archive files pertaining to the VG. -May be used with \-\-file. Does not restore the VG. +May be used with --file. Does not restore the VG. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP +\fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP .br Specifies the type of on-disk metadata to use. \fBlvm2\fP (or just \fB2\fP) is the current, standard format. @@ -274,21 +274,21 @@ can be used for accessing old data. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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-t\fP|\fB\-\-test\fP +\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 @@ -298,20 +298,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -337,20 +337,20 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. For example, LVM_VG_NAME can generally be substituted for a required VG parameter. .SH NOTES -To replace PVs, \fBvgdisplay \-\-partial \-\-verbose\fP will show the +To replace PVs, \fBvgdisplay --partial --verbose\fP will show the UUIDs and sizes of any PVs that are no longer present. If a PV in the VG is lost and you wish to substitute another of the same size, use -\fBpvcreate \-\-restorefile filename \-\-uuid uuid\fP (plus additional +\fBpvcreate --restorefile filename --uuid uuid\fP (plus additional arguments as appropriate) to initialise it with the same UUID as the missing PV. Repeat for all other missing PVs in the VG. Then use -\fBvgcfgrestore \-\-file filename\fP to restore the VG's metadata. +\fBvgcfgrestore --file filename\fP to restore the VG's metadata. .SH SEE ALSO .BR lvm (8) diff --git a/man/vgchange.8_pregen b/man/vgchange.8_pregen index ce7da74b7..df5c94693 100644 --- a/man/vgchange.8_pregen +++ b/man/vgchange.8_pregen @@ -1,6 +1,6 @@ .TH VGCHANGE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -vgchange \- Change volume group attributes +vgchange - Change volume group attributes . .SH SYNOPSIS \fBvgchange\fP \fIoption_args\fP @@ -11,187 +11,187 @@ vgchange \- Change volume group attributes .br .P .ad l - \fB-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP + \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP .ad b .br .ad l - \fB\-\-activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP + \fB--activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP .ad b .br .ad l - \fB\-\-addtag\fP \fITag\fP + \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 + \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP .ad b .br .ad l - \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP + \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB-c\fP|\fB\-\-clustered\fP \fBy\fP|\fBn\fP + \fB-c\fP|\fB--clustered\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB\-\-commandprofile\fP \fIString\fP + \fB--commandprofile\fP \fIString\fP .ad b .br .ad l - \fB\-\-config\fP \fIString\fP + \fB--config\fP \fIString\fP .ad b .br .ad l - \fB-d\fP|\fB\-\-debug\fP + \fB-d\fP|\fB--debug\fP .ad b .br .ad l - \fB\-\-deltag\fP \fITag\fP + \fB--deltag\fP \fITag\fP .ad b .br .ad l - \fB\-\-detachprofile\fP + \fB--detachprofile\fP .ad b .br .ad l - \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP + \fB--driverloaded\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB-f\fP|\fB\-\-force\fP + \fB-f\fP|\fB--force\fP .ad b .br .ad l - \fB-h\fP|\fB\-\-help\fP + \fB-h\fP|\fB--help\fP .ad b .br .ad l - \fB-K\fP|\fB\-\-ignoreactivationskip\fP + \fB-K\fP|\fB--ignoreactivationskip\fP .ad b .br .ad l - \fB\-\-ignorelockingfailure\fP + \fB--ignorelockingfailure\fP .ad b .br .ad l - \fB\-\-ignoremonitoring\fP + \fB--ignoremonitoring\fP .ad b .br .ad l - \fB\-\-ignoreskippedcluster\fP + \fB--ignoreskippedcluster\fP .ad b .br .ad l - \fB\-\-lockopt\fP \fIString\fP + \fB--lockopt\fP \fIString\fP .ad b .br .ad l - \fB\-\-lockstart\fP + \fB--lockstart\fP .ad b .br .ad l - \fB\-\-lockstop\fP + \fB--lockstop\fP .ad b .br .ad l - \fB\-\-locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP + \fB--locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP .ad b .br .ad l - \fB-l\fP|\fB\-\-logicalvolume\fP \fINumber\fP + \fB-l\fP|\fB--logicalvolume\fP \fINumber\fP .ad b .br .ad l - \fB\-\-longhelp\fP + \fB--longhelp\fP .ad b .br .ad l - \fB-p\fP|\fB\-\-maxphysicalvolumes\fP \fINumber\fP + \fB-p\fP|\fB--maxphysicalvolumes\fP \fINumber\fP .ad b .br .ad l - \fB\-\-metadataprofile\fP \fIString\fP + \fB--metadataprofile\fP \fIString\fP .ad b .br .ad l - \fB\-\-monitor\fP \fBy\fP|\fBn\fP + \fB--monitor\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB\-\-noudevsync\fP + \fB--noudevsync\fP .ad b .br .ad l - \fB-P\fP|\fB\-\-partial\fP + \fB-P\fP|\fB--partial\fP .ad b .br .ad l - \fB-s\fP|\fB\-\-physicalextentsize\fP \fISize\fP[m|UNIT] + \fB-s\fP|\fB--physicalextentsize\fP \fISize\fP[m|UNIT] .ad b .br .ad l - \fB\-\-poll\fP \fBy\fP|\fBn\fP + \fB--poll\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB\-\-profile\fP \fIString\fP + \fB--profile\fP \fIString\fP .ad b .br .ad l - \fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP + \fB--pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP .ad b .br .ad l - \fB-q\fP|\fB\-\-quiet\fP + \fB-q\fP|\fB--quiet\fP .ad b .br .ad l - \fB\-\-refresh\fP + \fB--refresh\fP .ad b .br .ad l - \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP + \fB--reportformat\fP \fBbasic\fP|\fBjson\fP .ad b .br .ad l - \fB-x\fP|\fB\-\-resizeable\fP \fBy\fP|\fBn\fP + \fB-x\fP|\fB--resizeable\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB-S\fP|\fB\-\-select\fP \fIString\fP + \fB-S\fP|\fB--select\fP \fIString\fP .ad b .br .ad l - \fB\-\-sysinit\fP + \fB--sysinit\fP .ad b .br .ad l - \fB\-\-systemid\fP \fIString\fP + \fB--systemid\fP \fIString\fP .ad b .br .ad l - \fB-t\fP|\fB\-\-test\fP + \fB-t\fP|\fB--test\fP .ad b .br .ad l - \fB-u\fP|\fB\-\-uuid\fP + \fB-u\fP|\fB--uuid\fP .ad b .br .ad l - \fB-v\fP|\fB\-\-verbose\fP + \fB-v\fP|\fB--verbose\fP .ad b .br .ad l - \fB\-\-version\fP + \fB--version\fP .ad b .br .ad l - \fB\-\-[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP + \fB--[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP .ad b .br .ad l - \fB-y\fP|\fB\-\-yes\fP + \fB-y\fP|\fB--yes\fP .ad b .SH DESCRIPTION vgchange changes VG attributes, changes LV activation in the kernel, and @@ -206,67 +206,67 @@ required, after which the others are optional. .P \fBvgchange\fP .RS 4 -( \fB-l\fP|\fB\-\-logicalvolume\fP \fINumber\fP, +( \fB-l\fP|\fB--logicalvolume\fP \fINumber\fP, .ad b .br .ad l - \fB-p\fP|\fB\-\-maxphysicalvolumes\fP \fINumber\fP, + \fB-p\fP|\fB--maxphysicalvolumes\fP \fINumber\fP, .ad b .br .ad l - \fB-u\fP|\fB\-\-uuid\fP, + \fB-u\fP|\fB--uuid\fP, .ad b .br .ad l - \fB-c\fP|\fB\-\-clustered\fP \fBy\fP|\fBn\fP, + \fB-c\fP|\fB--clustered\fP \fBy\fP|\fBn\fP, .ad b .br .ad l - \fB-s\fP|\fB\-\-physicalextentsize\fP \fISize\fP[m|UNIT], + \fB-s\fP|\fB--physicalextentsize\fP \fISize\fP[m|UNIT], .ad b .br .ad l - \fB-x\fP|\fB\-\-resizeable\fP \fBy\fP|\fBn\fP, + \fB-x\fP|\fB--resizeable\fP \fBy\fP|\fBn\fP, .ad b .br .ad l - \fB\-\-addtag\fP \fITag\fP, + \fB--addtag\fP \fITag\fP, .ad b .br .ad l - \fB\-\-deltag\fP \fITag\fP, + \fB--deltag\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, + \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP, .ad b .br .ad l - \fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP, + \fB--pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP, .ad b .br .ad l - \fB\-\-[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP, + \fB--[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP, .ad b .br .ad l - \fB\-\-systemid\fP \fIString\fP, + \fB--systemid\fP \fIString\fP, .ad b .br .ad l - \fB\-\-locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP, + \fB--locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP, .ad b .br .ad l - \fB\-\-profile\fP \fIString\fP, + \fB--profile\fP \fIString\fP, .ad b .br .ad l - \fB\-\-detachprofile\fP, + \fB--detachprofile\fP, .ad b .br .ad l - \fB\-\-metadataprofile\fP \fIString\fP ) + \fB--metadataprofile\fP \fIString\fP ) .RE .br .RS 4 @@ -281,19 +281,19 @@ required, after which the others are optional. Start or stop monitoring LVs from dmeventd. .br .P -\fBvgchange\fP \fB\-\-monitor\fP \fBy\fP|\fBn\fP +\fBvgchange\fP \fB--monitor\fP \fBy\fP|\fBn\fP .br .RS 4 .ad l -[ \fB\-\-sysinit\fP ] +[ \fB--sysinit\fP ] .ad b .br .ad l -[ \fB\-\-ignorelockingfailure\fP ] +[ \fB--ignorelockingfailure\fP ] .ad b .br .ad l -[ \fB\-\-poll\fP \fBy\fP|\fBn\fP ] +[ \fB--poll\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -307,11 +307,11 @@ Start or stop monitoring LVs from dmeventd. Start or stop processing LV conversions. .br .P -\fBvgchange\fP \fB\-\-poll\fP \fBy\fP|\fBn\fP +\fBvgchange\fP \fB--poll\fP \fBy\fP|\fBn\fP .br .RS 4 .ad l -[ \fB\-\-ignorelockingfailure\fP ] +[ \fB--ignorelockingfailure\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -325,35 +325,35 @@ Start or stop processing LV conversions. Activate or deactivate LVs. .br .P -\fBvgchange\fP \fB-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP +\fBvgchange\fP \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP .br .RS 4 .ad l -[ \fB-K\fP|\fB\-\-ignoreactivationskip\fP ] +[ \fB-K\fP|\fB--ignoreactivationskip\fP ] .ad b .br .ad l -[ \fB-P\fP|\fB\-\-partial\fP ] +[ \fB-P\fP|\fB--partial\fP ] .ad b .br .ad l -[ \fB\-\-activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP ] +[ \fB--activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP ] .ad b .br .ad l -[ \fB\-\-sysinit\fP ] +[ \fB--sysinit\fP ] .ad b .br .ad l -[ \fB\-\-ignorelockingfailure\fP ] +[ \fB--ignorelockingfailure\fP ] .ad b .br .ad l -[ \fB\-\-monitor\fP \fBy\fP|\fBn\fP ] +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-poll\fP \fBy\fP|\fBn\fP ] +[ \fB--poll\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -367,23 +367,23 @@ Activate or deactivate LVs. Reactivate LVs using the latest metadata. .br .P -\fBvgchange\fP \fB\-\-refresh\fP +\fBvgchange\fP \fB--refresh\fP .br .RS 4 .ad l -[ \fB\-\-sysinit\fP ] +[ \fB--sysinit\fP ] .ad b .br .ad l -[ \fB\-\-ignorelockingfailure\fP ] +[ \fB--ignorelockingfailure\fP ] .ad b .br .ad l -[ \fB\-\-monitor\fP \fBy\fP|\fBn\fP ] +[ \fB--monitor\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-poll\fP \fBy\fP|\fBn\fP ] +[ \fB--poll\fP \fBy\fP|\fBn\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -397,11 +397,11 @@ Reactivate LVs using the latest metadata. Start the lockspace of a shared VG in lvmlockd. .br .P -\fBvgchange\fP \fB\-\-lockstart\fP +\fBvgchange\fP \fB--lockstart\fP .br .RS 4 .ad l -[ \fB\-\-lockopt\fP \fIString\fP ] +[ \fB--lockopt\fP \fIString\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -415,11 +415,11 @@ Start the lockspace of a shared VG in lvmlockd. Stop the lockspace of a shared VG in lvmlockd. .br .P -\fBvgchange\fP \fB\-\-lockstop\fP +\fBvgchange\fP \fB--lockstop\fP .br .RS 4 .ad l -[ \fB\-\-lockopt\fP \fIString\fP ] +[ \fB--lockopt\fP \fIString\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -434,31 +434,31 @@ Common options for command: . .RS 4 .ad l -[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-f\fP|\fB\-\-force\fP ] +[ \fB-f\fP|\fB--force\fP ] .ad b .br .ad l -[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] +[ \fB-S\fP|\fB--select\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-ignoremonitoring\fP ] +[ \fB--ignoremonitoring\fP ] .ad b .br .ad l -[ \fB\-\-ignoreskippedcluster\fP ] +[ \fB--ignoreskippedcluster\fP ] .ad b .br .ad l -[ \fB\-\-noudevsync\fP ] +[ \fB--noudevsync\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .RE @@ -466,57 +466,57 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP +\fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP .br Change the active state of LVs. An active LV can be used through a block device, @@ -541,7 +541,7 @@ See clvmd(8) for more information about activation options \fBey\fP, \fBsy\fP, \ .ad b .HP .ad l -\fB\-\-activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP +\fB--activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP .br Determines if LV activation is allowed when PVs are missing, e.g. because of a device failure. @@ -556,14 +556,14 @@ See \fBlvmraid\fP(7) for more information. .ad b .HP .ad l -\fB\-\-addtag\fP \fITag\fP +\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 lvm(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 +\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 @@ -584,28 +584,28 @@ See \fBlvm\fP(8) for more information about allocation. .ad b .HP .ad l -\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP +\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 vgcfgbackup(8) for more information. .ad b .HP .ad l -\fB-c\fP|\fB\-\-clustered\fP \fBy\fP|\fBn\fP +\fB-c\fP|\fB--clustered\fP \fBy\fP|\fBn\fP .br Change the clustered property of a VG using clvmd. See clvmd(8) for more information about clustered VGs. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -614,83 +614,83 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-deltag\fP \fITag\fP +\fB--deltag\fP \fITag\fP .br Deletes a tag from a PV, VG or LV. This option can be repeated to delete multiple tags at once. See lvm(8) for information about tags. .ad b .HP .ad l -\fB\-\-detachprofile\fP +\fB--detachprofile\fP .br Detaches a metadata profile from a VG or LV. See \fBlvm.conf\fP(5) for more information about profiles. .ad b .HP .ad l -\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-f\fP|\fB\-\-force\fP ... +\fB-f\fP|\fB--force\fP ... .br Override various checks, confirmations and protections. Use with extreme caution. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB-K\fP|\fB\-\-ignoreactivationskip\fP +\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\-\-ignorelockingfailure\fP +\fB--ignorelockingfailure\fP .br Allows a command to continue with read-only metadata operations after locking failures. .ad b .HP .ad l -\fB\-\-ignoremonitoring\fP +\fB--ignoremonitoring\fP .br -Do not interact with dmeventd unless \-\-monitor is specified. +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\-\-ignoreskippedcluster\fP +\fB--ignoreskippedcluster\fP .br Use to avoid exiting with an non-zero status code if the command is run without clustered locking and clustered VGs are skipped. .ad b .HP .ad l -\fB\-\-lockopt\fP \fIString\fP +\fB--lockopt\fP \fIString\fP .br Used to pass options for special cases to lvmlockd. See lvmlockd(8) for more information. .ad b .HP .ad l -\fB\-\-lockstart\fP +\fB--lockstart\fP .br Start the lockspace of a shared VG in lvmlockd. lvmlockd locks becomes available for the VG, allowing LVM to use the VG. @@ -698,7 +698,7 @@ See lvmlockd(8) for more information. .ad b .HP .ad l -\fB\-\-lockstop\fP +\fB--lockstop\fP .br Stop the lockspace of a shared VG in lvmlockd. lvmlockd locks become unavailable for the VG, preventing LVM from using the VG. @@ -706,42 +706,42 @@ See lvmlockd(8) for more information. .ad b .HP .ad l -\fB\-\-locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP +\fB--locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP .br Change the VG lock type to or from a shared lock type used with lvmlockd. See lvmlockd(8) for more information. .ad b .HP .ad l -\fB-l\fP|\fB\-\-logicalvolume\fP \fINumber\fP +\fB-l\fP|\fB--logicalvolume\fP \fINumber\fP .br Sets the maximum number of LVs allowed in a VG. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB-p\fP|\fB\-\-maxphysicalvolumes\fP \fINumber\fP +\fB-p\fP|\fB--maxphysicalvolumes\fP \fINumber\fP .br Sets the maximum number of PVs that can belong to the VG. The value 0 removes any limitation. -For large numbers of PVs, also see options \-\-pvmetadatacopies, -and \-\-vgmetadatacopies for improving performance. +For large numbers of PVs, also see options --pvmetadatacopies, +and --vgmetadatacopies for improving performance. .ad b .HP .ad l -\fB\-\-metadataprofile\fP \fIString\fP +\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\-\-monitor\fP \fBy\fP|\fBn\fP +\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 @@ -750,7 +750,7 @@ See dmeventd(8) for more information. .ad b .HP .ad l -\fB\-\-noudevsync\fP +\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 @@ -759,7 +759,7 @@ ignore the devices LVM creates. .ad b .HP .ad l -\fB-P\fP|\fB\-\-partial\fP +\fB-P\fP|\fB--partial\fP .br When set, the tools will do their best to provide access to VGs that are only partially available (one or more PVs belonging @@ -768,7 +768,7 @@ changed with this option. .ad b .HP .ad l -\fB-s\fP|\fB\-\-physicalextentsize\fP \fISize\fP[m|UNIT] +\fB-s\fP|\fB--physicalextentsize\fP \fISize\fP[m|UNIT] .br Sets the physical extent size of PVs in the VG. The value must be either a power of 2 of at least 1 sector @@ -782,26 +782,26 @@ contiguous range of extents used in a LV must start and end on an extent boundar .ad b .HP .ad l -\fB\-\-poll\fP \fBy\fP|\fBn\fP +\fB--poll\fP \fBy\fP|\fBn\fP .br When yes, start the background transformation of an LV. An incomplete transformation, e.g. pvmove or lvconvert interrupted -by reboot or crash, can be restarted from the last checkpoint with \-\-poll y. +by reboot or crash, can be restarted from the last checkpoint with --poll y. When no, background transformation of an LV will not occur, and the transformation will not complete. It may not be appropriate to immediately -poll an LV after activation, in which case \-\-poll n can be used to defer -polling until a later \-\-poll y command. +poll an LV after activation, in which case --poll n can be used to defer +polling until a later --poll y command. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP +\fB--pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP .br The number of metadata areas to set aside on a PV for storing VG metadata. When 2, one copy of the VG metadata is stored at the front of the PV @@ -814,14 +814,14 @@ on the ability to use vgsplit later.) .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-refresh\fP +\fB--refresh\fP .br If the LV is active, reload its metadata. This is not necessary in normal operation, but may be useful @@ -830,7 +830,7 @@ sharing is being used. .ad b .HP .ad l -\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -841,19 +841,19 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-x\fP|\fB\-\-resizeable\fP \fBy\fP|\fBn\fP +\fB-x\fP|\fB--resizeable\fP \fBy\fP|\fBn\fP .br Enables or disables the addition or removal of PVs to/from a VG (by vgextend/vgreduce). .ad b .HP .ad l -\fB-S\fP|\fB\-\-select\fP \fIString\fP +\fB-S\fP|\fB--select\fP \fIString\fP .br Select objects for processing and reporting based on specified criteria. -The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). +The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7). For reporting commands, one row is displayed for each object matching the criteria. -See \fB\-\-options help\fP for selectable object fields. +See \fB--options help\fP for selectable object fields. Rows can be displayed with an additional "selected" field (-o selected) showing 1 if the row matches the selection and 0 otherwise. For non-reporting commands which process LVM entities, the selection is @@ -861,20 +861,20 @@ used to choose items to process. .ad b .HP .ad l -\fB\-\-sysinit\fP +\fB--sysinit\fP .br Indicates that vgchange/lvchange is being invoked from early system initialisation scripts (e.g. rc.sysinit or an initrd), before writable filesystems are 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. +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 .ad l -\fB\-\-systemid\fP \fIString\fP +\fB--systemid\fP \fIString\fP .br Changes the system ID of the VG. Using this option requires caution because the VG may become foreign to the host running the command, @@ -883,7 +883,7 @@ See lvmsystemid(7) for more information. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -893,26 +893,26 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-u\fP|\fB\-\-uuid\fP +\fB-u\fP|\fB--uuid\fP .br Generate new random UUID for specified VGs. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB\-\-[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP +\fB--[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP .br Number of copies of the VG metadata that are kept. VG metadata is kept in VG metadata areas on PVs in the VG, @@ -930,7 +930,7 @@ all PVs, and then to become unmanaged. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -950,7 +950,7 @@ in place of a VG, LV or PV. \fISelect\fP .br Select indicates that a required positional parameter can -be omitted if the \fB\-\-select\fP option is used. +be omitted if the \fB--select\fP option is used. No arg appears in this position. .HP \fIString\fP @@ -967,7 +967,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. @@ -979,11 +979,11 @@ snapshots should be removed. .SH EXAMPLES Activate all LVs in all VGs on all existing devices. .br -.B vgchange \-a y +.B vgchange -a y Change the maximum number of LVs for an inactive VG. .br -.B vgchange \-l 128 vg00 +.B vgchange -l 128 vg00 .SH SEE ALSO .BR lvm (8) diff --git a/man/vgck.8_pregen b/man/vgck.8_pregen index d172f187a..fa47193a5 100644 --- a/man/vgck.8_pregen +++ b/man/vgck.8_pregen @@ -1,6 +1,6 @@ .TH VGCK 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -vgck \- Check the consistency of volume group(s) +vgck - Check the consistency of volume group(s) . .SH SYNOPSIS \fBvgck\fP @@ -16,7 +16,7 @@ vgck checks LVM metadata for consistency. .br .RS 4 .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -30,64 +30,64 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -96,47 +96,47 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -147,7 +147,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -157,20 +157,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -201,7 +201,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/vgconvert.8_pregen b/man/vgconvert.8_pregen index 9c07bce93..ef524fea0 100644 --- a/man/vgconvert.8_pregen +++ b/man/vgconvert.8_pregen @@ -1,6 +1,6 @@ .TH VGCONVERT 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -vgconvert \- Change volume group metadata format +vgconvert - Change volume group metadata format . .SH SYNOPSIS \fBvgconvert\fP \fIposition_args\fP @@ -19,31 +19,31 @@ longer needed in general. .br .RS 4 .ad l -[ \fB-f\fP|\fB\-\-force\fP ] +[ \fB-f\fP|\fB--force\fP ] .ad b .br .ad l -[ \fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ] +[ \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ] .ad b .br .ad l -[ \fB\-\-labelsector\fP \fINumber\fP ] +[ \fB--labelsector\fP \fINumber\fP ] .ad b .br .ad l -[ \fB\-\-bootloaderareasize\fP \fISize\fP[m|UNIT] ] +[ \fB--bootloaderareasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP ] +[ \fB--pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP ] .ad b .br .ad l -[ \fB\-\-metadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--metadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -54,78 +54,78 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-bootloaderareasize\fP \fISize\fP[m|UNIT] +\fB--bootloaderareasize\fP \fISize\fP[m|UNIT] .br Create a separate bootloader area of specified size besides PV's data area. The bootloader area is an area of reserved space on the PV from which LVM will not allocate any extents and it's kept untouched. This is primarily aimed for use with bootloaders to embed their own data or metadata. -The start of the bootloader area is always aligned, see also \-\-dataalignment -and \-\-dataalignmentoffset. The bootloader area size may eventually +The start of the bootloader area is always aligned, see also --dataalignment +and --dataalignmentoffset. The bootloader area size may eventually end up increased due to the alignment, but it's never less than the size that is requested. To see the bootloader area start and size of an existing PV use pvs -o +pv_ba_start,pv_ba_size. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -134,34 +134,34 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-f\fP|\fB\-\-force\fP ... +\fB-f\fP|\fB--force\fP ... .br Override various checks, confirmations and protections. Use with extreme caution. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-labelsector\fP \fINumber\fP +\fB--labelsector\fP \fINumber\fP .br By default the PV is labelled with an LVM2 identifier in its second sector (sector 1). This lets you use a different sector near the @@ -170,20 +170,20 @@ in the source). Use with care. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-metadatasize\fP \fISize\fP[m|UNIT] +\fB--metadatasize\fP \fISize\fP[m|UNIT] .br The approximate amount of space used for each VG metadata area. The size may be rounded. .ad b .HP .ad l -\fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP +\fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP .br Specifies the type of on-disk metadata to use. \fBlvm2\fP (or just \fB2\fP) is the current, standard format. @@ -192,14 +192,14 @@ can be used for accessing old data. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP +\fB--pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP .br The number of metadata areas to set aside on a PV for storing VG metadata. When 2, one copy of the VG metadata is stored at the front of the PV @@ -212,14 +212,14 @@ on the ability to use vgsplit later.) .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -230,7 +230,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -240,20 +240,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -279,7 +279,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/vgcreate.8_pregen b/man/vgcreate.8_pregen index 871c6aa1c..d65d4e271 100644 --- a/man/vgcreate.8_pregen +++ b/man/vgcreate.8_pregen @@ -1,6 +1,6 @@ .TH VGCREATE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -vgcreate \- Create a volume group +vgcreate - Create a volume group . .SH SYNOPSIS \fBvgcreate\fP \fIposition_args\fP @@ -17,91 +17,91 @@ devices are also available with vgcreate. .br .RS 4 .ad l -[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB\-\-clustered\fP \fBy\fP|\fBn\fP ] +[ \fB-c\fP|\fB--clustered\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-l\fP|\fB\-\-maxlogicalvolumes\fP \fINumber\fP ] +[ \fB-l\fP|\fB--maxlogicalvolumes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-p\fP|\fB\-\-maxphysicalvolumes\fP \fINumber\fP ] +[ \fB-p\fP|\fB--maxphysicalvolumes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ] +[ \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ] .ad b .br .ad l -[ \fB-s\fP|\fB\-\-physicalextentsize\fP \fISize\fP[m|UNIT] ] +[ \fB-s\fP|\fB--physicalextentsize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB-f\fP|\fB\-\-force\fP ] +[ \fB-f\fP|\fB--force\fP ] .ad b .br .ad l -[ \fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP ] +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-addtag\fP \fITag\fP ] +[ \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 ] +[ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] .ad b .br .ad l -[ \fB\-\-metadataprofile\fP \fIString\fP ] +[ \fB--metadataprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-labelsector\fP \fINumber\fP ] +[ \fB--labelsector\fP \fINumber\fP ] .ad b .br .ad l -[ \fB\-\-metadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--metadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP ] +[ \fB--pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP ] .ad b .br .ad l -[ \fB\-\-[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP ] +[ \fB--[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br .ad l -[ \fB\-\-dataalignment\fP \fISize\fP[k|UNIT] ] +[ \fB--dataalignment\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-dataalignmentoffset\fP \fISize\fP[k|UNIT] ] +[ \fB--dataalignmentoffset\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-shared\fP ] +[ \fB--shared\fP ] .ad b .br .ad l -[ \fB\-\-systemid\fP \fIString\fP ] +[ \fB--systemid\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP ] +[ \fB--locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP ] .ad b .br .ad l -[ \fB\-\-lockopt\fP \fIString\fP ] +[ \fB--lockopt\fP \fIString\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -112,64 +112,64 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-addtag\fP \fITag\fP +\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 lvm(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 +\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 @@ -190,14 +190,14 @@ See \fBlvm\fP(8) for more information about allocation. .ad b .HP .ad l -\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP +\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 vgcfgbackup(8) for more information. .ad b .HP .ad l -\fB-c\fP|\fB\-\-clustered\fP \fBy\fP|\fBn\fP +\fB-c\fP|\fB--clustered\fP \fBy\fP|\fBn\fP .br Create a clustered VG using clvmd if LVM is compiled with cluster support. This allows multiple hosts to share a VG on shared devices. @@ -207,14 +207,14 @@ See clvmd(8) for more information about clustered VGs. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -223,50 +223,50 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB\-\-dataalignment\fP \fISize\fP[k|UNIT] +\fB--dataalignment\fP \fISize\fP[k|UNIT] .br Align the start of the data to a multiple of this number. Also specify an appropriate Physical Extent size when creating a VG. To see the location of the first Physical Extent of an existing PV, use pvs -o +pe_start. In addition, it may be shifted by an alignment offset. -See lvm.conf/data_alignment_offset_detection and \-\-dataalignmentoffset. +See lvm.conf/data_alignment_offset_detection and --dataalignmentoffset. .ad b .HP .ad l -\fB\-\-dataalignmentoffset\fP \fISize\fP[k|UNIT] +\fB--dataalignmentoffset\fP \fISize\fP[k|UNIT] .br Shift the start of the data area by this additional offset. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-f\fP|\fB\-\-force\fP ... +\fB-f\fP|\fB--force\fP ... .br Override various checks, confirmations and protections. Use with extreme caution. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-labelsector\fP \fINumber\fP +\fB--labelsector\fP \fINumber\fP .br By default the PV is labelled with an LVM2 identifier in its second sector (sector 1). This lets you use a different sector near the @@ -275,56 +275,56 @@ in the source). Use with care. .ad b .HP .ad l -\fB\-\-lockopt\fP \fIString\fP +\fB--lockopt\fP \fIString\fP .br Used to pass options for special cases to lvmlockd. See lvmlockd(8) for more information. .ad b .HP .ad l -\fB\-\-locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP +\fB--locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP .br -Specify the VG lock type directly in place of using \-\-shared. +Specify the VG lock type directly in place of using --shared. See lvmlockd(8) for more information. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB-l\fP|\fB\-\-maxlogicalvolumes\fP \fINumber\fP +\fB-l\fP|\fB--maxlogicalvolumes\fP \fINumber\fP .br Sets the maximum number of LVs allowed in a VG. .ad b .HP .ad l -\fB-p\fP|\fB\-\-maxphysicalvolumes\fP \fINumber\fP +\fB-p\fP|\fB--maxphysicalvolumes\fP \fINumber\fP .br Sets the maximum number of PVs that can belong to the VG. The value 0 removes any limitation. -For large numbers of PVs, also see options \-\-pvmetadatacopies, -and \-\-vgmetadatacopies for improving performance. +For large numbers of PVs, also see options --pvmetadatacopies, +and --vgmetadatacopies for improving performance. .ad b .HP .ad l -\fB\-\-metadataprofile\fP \fIString\fP +\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\-\-metadatasize\fP \fISize\fP[m|UNIT] +\fB--metadatasize\fP \fISize\fP[m|UNIT] .br The approximate amount of space used for each VG metadata area. The size may be rounded. .ad b .HP .ad l -\fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP +\fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP .br Specifies the type of on-disk metadata to use. \fBlvm2\fP (or just \fB2\fP) is the current, standard format. @@ -333,7 +333,7 @@ can be used for accessing old data. .ad b .HP .ad l -\fB-s\fP|\fB\-\-physicalextentsize\fP \fISize\fP[m|UNIT] +\fB-s\fP|\fB--physicalextentsize\fP \fISize\fP[m|UNIT] .br Sets the physical extent size of PVs in the VG. The value must be either a power of 2 of at least 1 sector @@ -344,14 +344,14 @@ without recreating the VG, unless no extents need moving. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP +\fB--pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP .br The number of metadata areas to set aside on a PV for storing VG metadata. When 2, one copy of the VG metadata is stored at the front of the PV @@ -364,14 +364,14 @@ on the ability to use vgsplit later.) .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -382,7 +382,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB\-\-shared\fP +\fB--shared\fP .br Create a shared VG using lvmlockd if LVM is compiled with lockd support. lvmlockd will select lock type sanlock or dlm depending on which lock @@ -393,7 +393,7 @@ See lvmlockd(8) for more information about shared VGs. .ad b .HP .ad l -\fB\-\-systemid\fP \fIString\fP +\fB--systemid\fP \fIString\fP .br Specifies the system ID that will be given to the new VG, overriding the system ID of the host running the command. A VG is normally created @@ -405,7 +405,7 @@ See lvmsystemid(7) for more information. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -415,20 +415,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB\-\-[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP +\fB--[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP .br Number of copies of the VG metadata that are kept. VG metadata is kept in VG metadata areas on PVs in the VG, @@ -446,7 +446,7 @@ all PVs, and then to become unmanaged. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -454,11 +454,11 @@ answer yes. Use with extreme caution. .ad b .HP .ad l -\fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP +\fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP .br Controls if the first 4 sectors (2048 bytes) of the device are wiped. The default is to wipe these sectors unless either or both of -\-\-restorefile or \-\-uuid are specified. +--restorefile or --uuid are specified. .ad b .SH VARIABLES .HP @@ -490,7 +490,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/vgdisplay.8_pregen b/man/vgdisplay.8_pregen index 196aee4c1..2aa9188ff 100644 --- a/man/vgdisplay.8_pregen +++ b/man/vgdisplay.8_pregen @@ -1,6 +1,6 @@ .TH VGDISPLAY 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -vgdisplay \- Display volume group information +vgdisplay - Display volume group information . .SH SYNOPSIS \fBvgdisplay\fP @@ -19,95 +19,95 @@ and more, using a more compact and configurable output format. .br .RS 4 .ad l -[ \fB-A\fP|\fB\-\-activevolumegroups\fP ] +[ \fB-A\fP|\fB--activevolumegroups\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB\-\-colon\fP ] +[ \fB-c\fP|\fB--colon\fP ] .ad b .br .ad l -[ \fB-C\fP|\fB\-\-columns\fP ] +[ \fB-C\fP|\fB--columns\fP ] .ad b .br .ad l -[ \fB-o\fP|\fB\-\-options\fP \fIString\fP ] +[ \fB-o\fP|\fB--options\fP \fIString\fP ] .ad b .br .ad l -[ \fB-P\fP|\fB\-\-partial\fP ] +[ \fB-P\fP|\fB--partial\fP ] .ad b .br .ad l -[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] +[ \fB-S\fP|\fB--select\fP \fIString\fP ] .ad b .br .ad l -[ \fB-s\fP|\fB\-\-short\fP ] +[ \fB-s\fP|\fB--short\fP ] .ad b .br .ad l -[ \fB-O\fP|\fB\-\-sort\fP \fIString\fP ] +[ \fB-O\fP|\fB--sort\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-aligned\fP ] +[ \fB--aligned\fP ] .ad b .br .ad l -[ \fB\-\-binary\fP ] +[ \fB--binary\fP ] .ad b .br .ad l -[ \fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ] +[ \fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ] .ad b .br .ad l -[ \fB\-\-foreign\fP ] +[ \fB--foreign\fP ] .ad b .br .ad l -[ \fB\-\-ignorelockingfailure\fP ] +[ \fB--ignorelockingfailure\fP ] .ad b .br .ad l -[ \fB\-\-ignoreskippedcluster\fP ] +[ \fB--ignoreskippedcluster\fP ] .ad b .br .ad l -[ \fB\-\-logonly\fP ] +[ \fB--logonly\fP ] .ad b .br .ad l -[ \fB\-\-noheadings\fP ] +[ \fB--noheadings\fP ] .ad b .br .ad l -[ \fB\-\-nosuffix\fP ] +[ \fB--nosuffix\fP ] .ad b .br .ad l -[ \fB\-\-readonly\fP ] +[ \fB--readonly\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br .ad l -[ \fB\-\-shared\fP ] +[ \fB--shared\fP ] .ad b .br .ad l -[ \fB\-\-separator\fP \fIString\fP ] +[ \fB--separator\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-unbuffered\fP ] +[ \fB--unbuffered\fP ] .ad b .br .ad l -[ \fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ] +[ \fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -121,70 +121,70 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB-A\fP|\fB\-\-activevolumegroups\fP +\fB-A\fP|\fB--activevolumegroups\fP .br Only select active VGs. The VG is considered active if at least one of its LVs is active. .ad b .HP .ad l -\fB\-\-aligned\fP +\fB--aligned\fP .br -Use with \-\-separator to align the output columns +Use with --separator to align the output columns .ad b .HP .ad l -\fB\-\-binary\fP +\fB--binary\fP .br Use binary values "0" or "1" instead of descriptive literal values for columns that have exactly two valid values to report (not counting @@ -192,28 +192,28 @@ the "unknown" value which denotes that the value could not be determined). .ad b .HP .ad l -\fB-c\fP|\fB\-\-colon\fP +\fB-c\fP|\fB--colon\fP .br Generate colon separated output for easier parsing in scripts or programs. Also see vgs(8) which provides considerably more control over the output. .ad b .HP .ad l -\fB-C\fP|\fB\-\-columns\fP +\fB-C\fP|\fB--columns\fP .br Display output in columns, the equivalent of vgs(8). Options listed are the same as options given in vgs(8). .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -222,80 +222,80 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP +\fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP .br See lvmreport(7). .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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\-\-foreign\fP +\fB--foreign\fP .br Report/display foreign VGs that would otherwise be skipped. See lvmsystemid(7) for more information about foreign VGs. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-ignorelockingfailure\fP +\fB--ignorelockingfailure\fP .br Allows a command to continue with read-only metadata operations after locking failures. .ad b .HP .ad l -\fB\-\-ignoreskippedcluster\fP +\fB--ignoreskippedcluster\fP .br Use to avoid exiting with an non-zero status code if the command is run without clustered locking and clustered VGs are skipped. .ad b .HP .ad l -\fB\-\-logonly\fP +\fB--logonly\fP .br Suppress command report and display only log report. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-noheadings\fP +\fB--noheadings\fP .br Suppress the headings line that is normally the first line of output. Useful if grepping the output. .ad b .HP .ad l -\fB\-\-nosuffix\fP +\fB--nosuffix\fP .br -Suppress the suffix on output sizes. Use with \-\-units +Suppress the suffix on output sizes. Use with --units (except h and H) if processing the output. .ad b .HP .ad l -\fB-o\fP|\fB\-\-options\fP \fIString\fP +\fB-o\fP|\fB--options\fP \fIString\fP .br Comma-separated, ordered list of fields to display in columns. String arg syntax is: [+|-|#]Field1[,Field2 ...] @@ -317,7 +317,7 @@ See lvmreport(7) for more information about reporting. .ad b .HP .ad l -\fB-P\fP|\fB\-\-partial\fP +\fB-P\fP|\fB--partial\fP .br When set, the tools will do their best to provide access to VGs that are only partially available (one or more PVs belonging @@ -326,21 +326,21 @@ changed with this option. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-readonly\fP +\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 @@ -354,7 +354,7 @@ actually in use. .ad b .HP .ad l -\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -365,12 +365,12 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-S\fP|\fB\-\-select\fP \fIString\fP +\fB-S\fP|\fB--select\fP \fIString\fP .br Select objects for processing and reporting based on specified criteria. -The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). +The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7). For reporting commands, one row is displayed for each object matching the criteria. -See \fB\-\-options help\fP for selectable object fields. +See \fB--options help\fP for selectable object fields. Rows can be displayed with an additional "selected" field (-o selected) showing 1 if the row matches the selection and 0 otherwise. For non-reporting commands which process LVM entities, the selection is @@ -378,13 +378,13 @@ used to choose items to process. .ad b .HP .ad l -\fB\-\-separator\fP \fIString\fP +\fB--separator\fP \fIString\fP .br String to use to separate each column. Useful if grepping the output. .ad b .HP .ad l -\fB\-\-shared\fP +\fB--shared\fP .br Report/display shared VGs that would otherwise be skipped when lvmlockd is not being used on the host. @@ -392,20 +392,20 @@ See lvmlockd(8) for more information about shared VGs. .ad b .HP .ad l -\fB-s\fP|\fB\-\-short\fP +\fB-s\fP|\fB--short\fP .br Give a short listing showing the existence of VGs. .ad b .HP .ad l -\fB-O\fP|\fB\-\-sort\fP \fIString\fP +\fB-O\fP|\fB--sort\fP \fIString\fP .br Comma-separated ordered list of columns to sort by. Replaces the default selection. Precede any column with \fB-\fP for a reverse sort on that column. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -415,37 +415,37 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB\-\-unbuffered\fP +\fB--unbuffered\fP .br Produce output immediately without sorting or aligning the columns properly. .ad b .HP .ad l -\fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP +\fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP .br All sizes are output in these units: human-(r)eadable with '<' rounding indicator, (h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes. Capitalise to use multiples of 1000 (S.I.) instead of 1024. -Custom units can be specified, e.g. \-\-units 3M. +Custom units can be specified, e.g. --units 3M. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -476,7 +476,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/vgexport.8_pregen b/man/vgexport.8_pregen index 9797bb4ae..ee6973199 100644 --- a/man/vgexport.8_pregen +++ b/man/vgexport.8_pregen @@ -1,6 +1,6 @@ .TH VGEXPORT 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -vgexport \- Unregister volume group(s) from the system +vgexport - Unregister volume group(s) from the system . .SH SYNOPSIS \fBvgexport\fP \fIoption_args\fP \fIposition_args\fP @@ -24,7 +24,7 @@ Export specified VGs. .br .RS 4 .ad l -[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] +[ \fB-S\fP|\fB--select\fP \fIString\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -34,7 +34,7 @@ Export specified VGs. Export all VGs. .br .P -\fBvgexport\fP \fB-a\fP|\fB\-\-all\fP +\fBvgexport\fP \fB-a\fP|\fB--all\fP .br .RS 4 [ COMMON_OPTIONS ] @@ -45,7 +45,7 @@ Common options for command: . .RS 4 .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .RE @@ -53,69 +53,69 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB-a\fP|\fB\-\-all\fP +\fB-a\fP|\fB--all\fP .br .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -124,47 +124,47 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -175,12 +175,12 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-S\fP|\fB\-\-select\fP \fIString\fP +\fB-S\fP|\fB--select\fP \fIString\fP .br Select objects for processing and reporting based on specified criteria. -The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). +The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7). For reporting commands, one row is displayed for each object matching the criteria. -See \fB\-\-options help\fP for selectable object fields. +See \fB--options help\fP for selectable object fields. Rows can be displayed with an additional "selected" field (-o selected) showing 1 if the row matches the selection and 0 otherwise. For non-reporting commands which process LVM entities, the selection is @@ -188,7 +188,7 @@ used to choose items to process. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -198,20 +198,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -231,7 +231,7 @@ in place of a VG, LV or PV. \fISelect\fP .br Select indicates that a required positional parameter can -be omitted if the \fB\-\-select\fP option is used. +be omitted if the \fB--select\fP option is used. No arg appears in this position. .HP \fIString\fP @@ -248,7 +248,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/vgextend.8_pregen b/man/vgextend.8_pregen index 915091869..23d83c9a5 100644 --- a/man/vgextend.8_pregen +++ b/man/vgextend.8_pregen @@ -1,6 +1,6 @@ .TH VGEXTEND 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -vgextend \- Add physical volumes to a volume group +vgextend - Add physical volumes to a volume group . .SH SYNOPSIS \fBvgextend\fP \fIposition_args\fP @@ -13,62 +13,62 @@ for LVs in the VG. Also, PVs that have gone missing and then returned, e.g. due to a transient device failure, can be added back to the VG without -re-initializing them (see \-\-restoremissing). +re-initializing them (see --restoremissing). If the specified PVs have not yet been initialized with pvcreate, vgextend will initialize them. In this case pvcreate options can be used, e.g. -\-\-labelsector, \-\-metadatasize, \-\-metadataignore, -\-\-pvmetadatacopies, \-\-dataalignment, \-\-dataalignmentoffset. +--labelsector, --metadatasize, --metadataignore, +--pvmetadatacopies, --dataalignment, --dataalignmentoffset. .SH USAGE \fBvgextend\fP \fIVG\fP \fIPV\fP ... .br .RS 4 .ad l -[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-f\fP|\fB\-\-force\fP ] +[ \fB-f\fP|\fB--force\fP ] .ad b .br .ad l -[ \fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP ] +[ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ] +[ \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ] .ad b .br .ad l -[ \fB\-\-labelsector\fP \fINumber\fP ] +[ \fB--labelsector\fP \fINumber\fP ] .ad b .br .ad l -[ \fB\-\-metadatasize\fP \fISize\fP[m|UNIT] ] +[ \fB--metadatasize\fP \fISize\fP[m|UNIT] ] .ad b .br .ad l -[ \fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP ] +[ \fB--pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP ] .ad b .br .ad l -[ \fB\-\-metadataignore\fP \fBy\fP|\fBn\fP ] +[ \fB--metadataignore\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-dataalignment\fP \fISize\fP[k|UNIT] ] +[ \fB--dataalignment\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-dataalignmentoffset\fP \fISize\fP[k|UNIT] ] +[ \fB--dataalignmentoffset\fP \fISize\fP[k|UNIT] ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br .ad l -[ \fB\-\-restoremissing\fP ] +[ \fB--restoremissing\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -79,71 +79,71 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP +\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 vgcfgbackup(8) for more information. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -152,50 +152,50 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB\-\-dataalignment\fP \fISize\fP[k|UNIT] +\fB--dataalignment\fP \fISize\fP[k|UNIT] .br Align the start of the data to a multiple of this number. Also specify an appropriate Physical Extent size when creating a VG. To see the location of the first Physical Extent of an existing PV, use pvs -o +pe_start. In addition, it may be shifted by an alignment offset. -See lvm.conf/data_alignment_offset_detection and \-\-dataalignmentoffset. +See lvm.conf/data_alignment_offset_detection and --dataalignmentoffset. .ad b .HP .ad l -\fB\-\-dataalignmentoffset\fP \fISize\fP[k|UNIT] +\fB--dataalignmentoffset\fP \fISize\fP[k|UNIT] .br Shift the start of the data area by this additional offset. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-f\fP|\fB\-\-force\fP ... +\fB-f\fP|\fB--force\fP ... .br Override various checks, confirmations and protections. Use with extreme caution. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-labelsector\fP \fINumber\fP +\fB--labelsector\fP \fINumber\fP .br By default the PV is labelled with an LVM2 identifier in its second sector (sector 1). This lets you use a different sector near the @@ -204,13 +204,13 @@ in the source). Use with care. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-metadataignore\fP \fBy\fP|\fBn\fP +\fB--metadataignore\fP \fBy\fP|\fBn\fP .br Specifies the metadataignore property of a PV. If yes, metadata areas on the PV are ignored, and lvm will @@ -219,14 +219,14 @@ If no, lvm will store metadata on the PV. .ad b .HP .ad l -\fB\-\-metadatasize\fP \fISize\fP[m|UNIT] +\fB--metadatasize\fP \fISize\fP[m|UNIT] .br The approximate amount of space used for each VG metadata area. The size may be rounded. .ad b .HP .ad l -\fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP +\fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP .br Specifies the type of on-disk metadata to use. \fBlvm2\fP (or just \fB2\fP) is the current, standard format. @@ -235,14 +235,14 @@ can be used for accessing old data. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP +\fB--pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP .br The number of metadata areas to set aside on a PV for storing VG metadata. When 2, one copy of the VG metadata is stored at the front of the PV @@ -255,14 +255,14 @@ on the ability to use vgsplit later.) .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -273,14 +273,14 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB\-\-restoremissing\fP +\fB--restoremissing\fP .br Add a PV back into a VG after the PV was missing and then returned, e.g. due to a transient failure. The PV is not reinitialized. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -290,20 +290,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -311,11 +311,11 @@ answer yes. Use with extreme caution. .ad b .HP .ad l -\fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP +\fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP .br Controls if the first 4 sectors (2048 bytes) of the device are wiped. The default is to wipe these sectors unless either or both of -\-\-restorefile or \-\-uuid are specified. +--restorefile or --uuid are specified. .ad b .SH VARIABLES .HP @@ -347,7 +347,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/vgimport.8_pregen b/man/vgimport.8_pregen index 67635f3d7..138a239e7 100644 --- a/man/vgimport.8_pregen +++ b/man/vgimport.8_pregen @@ -1,6 +1,6 @@ .TH VGIMPORT 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -vgimport \- Register exported volume group with system +vgimport - Register exported volume group with system . .SH SYNOPSIS \fBvgimport\fP \fIoption_args\fP \fIposition_args\fP @@ -21,7 +21,7 @@ Import specified VGs. .br .RS 4 .ad l -[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] +[ \fB-S\fP|\fB--select\fP \fIString\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -31,7 +31,7 @@ Import specified VGs. Import all VGs. .br .P -\fBvgimport\fP \fB-a\fP|\fB\-\-all\fP +\fBvgimport\fP \fB-a\fP|\fB--all\fP .br .RS 4 [ COMMON_OPTIONS ] @@ -42,11 +42,11 @@ Common options for command: . .RS 4 .ad l -[ \fB-f\fP|\fB\-\-force\fP ] +[ \fB-f\fP|\fB--force\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .RE @@ -54,69 +54,69 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB-a\fP|\fB\-\-all\fP +\fB-a\fP|\fB--all\fP .br .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -125,54 +125,54 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-f\fP|\fB\-\-force\fP ... +\fB-f\fP|\fB--force\fP ... .br Override various checks, confirmations and protections. Use with extreme caution. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -183,12 +183,12 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-S\fP|\fB\-\-select\fP \fIString\fP +\fB-S\fP|\fB--select\fP \fIString\fP .br Select objects for processing and reporting based on specified criteria. -The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). +The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7). For reporting commands, one row is displayed for each object matching the criteria. -See \fB\-\-options help\fP for selectable object fields. +See \fB--options help\fP for selectable object fields. Rows can be displayed with an additional "selected" field (-o selected) showing 1 if the row matches the selection and 0 otherwise. For non-reporting commands which process LVM entities, the selection is @@ -196,7 +196,7 @@ used to choose items to process. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -206,20 +206,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -239,7 +239,7 @@ in place of a VG, LV or PV. \fISelect\fP .br Select indicates that a required positional parameter can -be omitted if the \fB\-\-select\fP option is used. +be omitted if the \fB--select\fP option is used. No arg appears in this position. .HP \fIString\fP @@ -256,7 +256,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/vgimportclone.8_pregen b/man/vgimportclone.8_pregen index deefcde02..3c5245e05 100644 --- a/man/vgimportclone.8_pregen +++ b/man/vgimportclone.8_pregen @@ -1,6 +1,6 @@ .TH VGIMPORTCLONE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -vgimportclone \- Import a VG from cloned PVs +vgimportclone - Import a VG from cloned PVs . .SH SYNOPSIS \fBvgimportclone\fP \fIposition_args\fP @@ -19,11 +19,11 @@ changes the associated VG and PV UUIDs. .br .RS 4 .ad l -[ \fB-n\fP|\fB\-\-basevgname\fP \fIVG\fP ] +[ \fB-n\fP|\fB--basevgname\fP \fIVG\fP ] .ad b .br .ad l -[ \fB-i\fP|\fB\-\-import\fP ] +[ \fB-i\fP|\fB--import\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -34,57 +34,57 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB-n\fP|\fB\-\-basevgname\fP \fIString\fP +\fB-n\fP|\fB--basevgname\fP \fIString\fP .br By default the snapshot VG will be renamed to the original name plus a numeric suffix to avoid duplicate naming (e.g. 'test_vg' would be renamed @@ -94,14 +94,14 @@ a numeric suffix will be added (like the previous example) to make it unique. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -110,54 +110,54 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB-i\fP|\fB\-\-import\fP +\fB-i\fP|\fB--import\fP .br Import exported VGs. Otherwise VGs that have been exported will not be changed (nor will their associated PVs). .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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-t\fP|\fB\-\-test\fP +\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 @@ -167,20 +167,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -212,7 +212,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. @@ -224,7 +224,7 @@ The corresponding PVs from a hardware snapshot are "/dev/sdc" and "/dev/sdd". Rename the VG associated with "/dev/sdc" and "/dev/sdd" from "vg00" to "vg00_snap" (and change associated UUIDs). .br -.B vgimportclone \-\-basevgname vg00_snap /dev/sdc /dev/sdd +.B vgimportclone --basevgname vg00_snap /dev/sdc /dev/sdd .SH SEE ALSO .BR lvm (8) diff --git a/man/vgmerge.8_pregen b/man/vgmerge.8_pregen index 367d4798e..8705d762b 100644 --- a/man/vgmerge.8_pregen +++ b/man/vgmerge.8_pregen @@ -1,6 +1,6 @@ .TH VGMERGE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -vgmerge \- Merge volume groups +vgmerge - Merge volume groups . .SH SYNOPSIS \fBvgmerge\fP \fIposition_args\fP @@ -16,11 +16,11 @@ of both VGs fit into the destination VG's limits. .br .RS 4 .ad l -[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-l\fP|\fB\-\-list\fP ] +[ \fB-l\fP|\fB--list\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -31,71 +31,71 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP +\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 vgcfgbackup(8) for more information. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -104,53 +104,53 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB-l\fP|\fB\-\-list\fP +\fB-l\fP|\fB--list\fP .br Display merged destination VG like vgdisplay -v. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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-t\fP|\fB\-\-test\fP +\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 @@ -160,20 +160,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -199,7 +199,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. @@ -209,7 +209,7 @@ For example, LVM_VG_NAME can generally be substituted for a required VG paramete Merge an inactive VG named "vg00" into the active or inactive VG named "databases", giving verbose runtime information. .br -.B vgmerge \-v databases vg00 +.B vgmerge -v databases vg00 .SH SEE ALSO .BR lvm (8) diff --git a/man/vgmknodes.8_pregen b/man/vgmknodes.8_pregen index 511b80e8c..5bfd1a870 100644 --- a/man/vgmknodes.8_pregen +++ b/man/vgmknodes.8_pregen @@ -1,6 +1,6 @@ .TH VGMKNODES 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -vgmknodes \- Create the special files for volume group devices in /dev +vgmknodes - Create the special files for volume group devices in /dev . .SH SYNOPSIS \fBvgmknodes\fP @@ -20,15 +20,15 @@ interoperating correctly. .br .RS 4 .ad l -[ \fB\-\-ignorelockingfailure\fP ] +[ \fB--ignorelockingfailure\fP ] .ad b .br .ad l -[ \fB\-\-refresh\fP ] +[ \fB--refresh\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -42,64 +42,64 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -108,54 +108,54 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-ignorelockingfailure\fP +\fB--ignorelockingfailure\fP .br Allows a command to continue with read-only metadata operations after locking failures. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-refresh\fP +\fB--refresh\fP .br If the LV is active, reload its metadata. This is not necessary in normal operation, but may be useful @@ -164,7 +164,7 @@ sharing is being used. .ad b .HP .ad l -\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -175,7 +175,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -185,20 +185,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -234,7 +234,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/vgreduce.8_pregen b/man/vgreduce.8_pregen index f11b39fe8..98a2278a6 100644 --- a/man/vgreduce.8_pregen +++ b/man/vgreduce.8_pregen @@ -1,6 +1,6 @@ .TH VGREDUCE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -vgreduce \- Remove physical volume(s) from a volume group +vgreduce - Remove physical volume(s) from a volume group . .SH SYNOPSIS \fBvgreduce\fP \fIoption_args\fP \fIposition_args\fP @@ -9,75 +9,75 @@ vgreduce \- Remove physical volume(s) from a volume group .br .P .ad l - \fB-a\fP|\fB\-\-all\fP + \fB-a\fP|\fB--all\fP .ad b .br .ad l - \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP + \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB\-\-commandprofile\fP \fIString\fP + \fB--commandprofile\fP \fIString\fP .ad b .br .ad l - \fB\-\-config\fP \fIString\fP + \fB--config\fP \fIString\fP .ad b .br .ad l - \fB-d\fP|\fB\-\-debug\fP + \fB-d\fP|\fB--debug\fP .ad b .br .ad l - \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP + \fB--driverloaded\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB-f\fP|\fB\-\-force\fP + \fB-f\fP|\fB--force\fP .ad b .br .ad l - \fB-h\fP|\fB\-\-help\fP + \fB-h\fP|\fB--help\fP .ad b .br .ad l - \fB\-\-longhelp\fP + \fB--longhelp\fP .ad b .br .ad l - \fB\-\-mirrorsonly\fP + \fB--mirrorsonly\fP .ad b .br .ad l - \fB\-\-profile\fP \fIString\fP + \fB--profile\fP \fIString\fP .ad b .br .ad l - \fB-q\fP|\fB\-\-quiet\fP + \fB-q\fP|\fB--quiet\fP .ad b .br .ad l - \fB\-\-removemissing\fP + \fB--removemissing\fP .ad b .br .ad l - \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP + \fB--reportformat\fP \fBbasic\fP|\fBjson\fP .ad b .br .ad l - \fB-t\fP|\fB\-\-test\fP + \fB-t\fP|\fB--test\fP .ad b .br .ad l - \fB-v\fP|\fB\-\-verbose\fP + \fB-v\fP|\fB--verbose\fP .ad b .br .ad l - \fB\-\-version\fP + \fB--version\fP .ad b .br .ad l - \fB-y\fP|\fB\-\-yes\fP + \fB-y\fP|\fB--yes\fP .ad b .SH DESCRIPTION vgreduce removes one or more unused PVs from a VG. @@ -96,7 +96,7 @@ Remove a PV from a VG. Remove all unused PVs from a VG. .br .P -\fBvgreduce\fP \fB-a\fP|\fB\-\-all\fP \fIVG\fP +\fBvgreduce\fP \fB-a\fP|\fB--all\fP \fIVG\fP .br .RS 4 [ COMMON_OPTIONS ] @@ -107,11 +107,11 @@ Remove all unused PVs from a VG. Remove all missing PVs from a VG. .br .P -\fBvgreduce\fP \fB\-\-removemissing\fP \fIVG\fP +\fBvgreduce\fP \fB--removemissing\fP \fIVG\fP .br .RS 4 .ad l -[ \fB\-\-mirrorsonly\fP ] +[ \fB--mirrorsonly\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -123,15 +123,15 @@ Common options for command: . .RS 4 .ad l -[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-f\fP|\fB\-\-force\fP ] +[ \fB-f\fP|\fB--force\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .RE @@ -139,77 +139,77 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB-a\fP|\fB\-\-all\fP +\fB-a\fP|\fB--all\fP .br Removes all empty PVs if none are named on the command line. .ad b .HP .ad l -\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP +\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 vgcfgbackup(8) for more information. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -218,66 +218,66 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-f\fP|\fB\-\-force\fP ... +\fB-f\fP|\fB--force\fP ... .br Override various checks, confirmations and protections. Use with extreme caution. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-mirrorsonly\fP +\fB--mirrorsonly\fP .br Only remove missing PVs from mirror LVs. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-removemissing\fP +\fB--removemissing\fP .br Removes all missing PVs from the VG, if there are no LVs allocated on them. This resumes normal operation of the VG (new LVs may again be created, changed and so on). If this is not possible because LVs are referencing the missing PVs, -this option can be combined with \-\-force to have the command remove +this option can be combined with --force to have the command remove any partial LVs. In this case, any LVs and dependent snapshots that were partly on the missing disks are removed completely, including those parts on disks that are still present. @@ -286,7 +286,7 @@ some data first may be possible by activating LVs in partial mode. .ad b .HP .ad l -\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -297,7 +297,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -307,20 +307,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -356,7 +356,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/vgremove.8_pregen b/man/vgremove.8_pregen index b655545a4..8ede805ad 100644 --- a/man/vgremove.8_pregen +++ b/man/vgremove.8_pregen @@ -1,6 +1,6 @@ .TH VGREMOVE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -vgremove \- Remove volume group(s) +vgremove - Remove volume group(s) . .SH SYNOPSIS \fBvgremove\fP \fIposition_args\fP @@ -12,7 +12,7 @@ vgremove removes one or more VGs. If LVs exist in the VG, a prompt is used to confirm LV removal. If one or more PVs in the VG are lost, consider -\fBvgreduce \-\-removemissing\fP to make the VG +\fBvgreduce --removemissing\fP to make the VG metadata consistent again. Repeat the force option (\fB-ff\fP) to forcibly remove LVs in the VG @@ -22,19 +22,19 @@ without confirmation. .br .RS 4 .ad l -[ \fB-f\fP|\fB\-\-force\fP ] +[ \fB-f\fP|\fB--force\fP ] .ad b .br .ad l -[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] +[ \fB-S\fP|\fB--select\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-noudevsync\fP ] +[ \fB--noudevsync\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -45,64 +45,64 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -111,40 +111,40 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-f\fP|\fB\-\-force\fP ... +\fB-f\fP|\fB--force\fP ... .br Override various checks, confirmations and protections. Use with extreme caution. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-noudevsync\fP +\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 @@ -153,21 +153,21 @@ ignore the devices LVM creates. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -178,12 +178,12 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-S\fP|\fB\-\-select\fP \fIString\fP +\fB-S\fP|\fB--select\fP \fIString\fP .br Select objects for processing and reporting based on specified criteria. -The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). +The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7). For reporting commands, one row is displayed for each object matching the criteria. -See \fB\-\-options help\fP for selectable object fields. +See \fB--options help\fP for selectable object fields. Rows can be displayed with an additional "selected" field (-o selected) showing 1 if the row matches the selection and 0 otherwise. For non-reporting commands which process LVM entities, the selection is @@ -191,7 +191,7 @@ used to choose items to process. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -201,20 +201,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -234,7 +234,7 @@ in place of a VG, LV or PV. \fISelect\fP .br Select indicates that a required positional parameter can -be omitted if the \fB\-\-select\fP option is used. +be omitted if the \fB--select\fP option is used. No arg appears in this position. .HP \fIString\fP @@ -251,7 +251,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/vgrename.8_pregen b/man/vgrename.8_pregen index 9668500fc..0dd21d43e 100644 --- a/man/vgrename.8_pregen +++ b/man/vgrename.8_pregen @@ -1,6 +1,6 @@ .TH VGRENAME 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -vgrename \- Rename a volume group +vgrename - Rename a volume group . .SH SYNOPSIS \fBvgrename\fP \fIposition_args\fP @@ -42,15 +42,15 @@ Common options for command: . .RS 4 .ad l -[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-f\fP|\fB\-\-force\fP ] +[ \fB-f\fP|\fB--force\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .RE @@ -58,71 +58,71 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP +\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 vgcfgbackup(8) for more information. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -131,54 +131,54 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-f\fP|\fB\-\-force\fP ... +\fB-f\fP|\fB--force\fP ... .br Override various checks, confirmations and protections. Use with extreme caution. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -189,7 +189,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -199,20 +199,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -238,7 +238,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. @@ -251,7 +251,7 @@ Rename VG "vg02" to "myvg": Rename the VG with the specified UUID to "myvg". .br -.B vgrename Zvlifi\-Ep3t\-e0Ng\-U42h\-o0ye\-KHu1\-nl7Ns4 myvg +.B vgrename Zvlifi-Ep3t-e0Ng-U42h-o0ye-KHu1-nl7Ns4 myvg .SH SEE ALSO .BR lvm (8) diff --git a/man/vgs.8_pregen b/man/vgs.8_pregen index 438a24a98..012697c22 100644 --- a/man/vgs.8_pregen +++ b/man/vgs.8_pregen @@ -1,6 +1,6 @@ .TH VGS 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -vgs \- Display information about volume groups +vgs - Display information about volume groups . .SH SYNOPSIS \fBvgs\fP @@ -16,103 +16,103 @@ vgs produces formatted output about VGs. .br .RS 4 .ad l -[ \fB-a\fP|\fB\-\-all\fP ] +[ \fB-a\fP|\fB--all\fP ] .ad b .br .ad l -[ \fB-o\fP|\fB\-\-options\fP \fIString\fP ] +[ \fB-o\fP|\fB--options\fP \fIString\fP ] .ad b .br .ad l -[ \fB-P\fP|\fB\-\-partial\fP ] +[ \fB-P\fP|\fB--partial\fP ] .ad b .br .ad l -[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] +[ \fB-S\fP|\fB--select\fP \fIString\fP ] .ad b .br .ad l -[ \fB-O\fP|\fB\-\-sort\fP \fIString\fP ] +[ \fB-O\fP|\fB--sort\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-aligned\fP ] +[ \fB--aligned\fP ] .ad b .br .ad l -[ \fB\-\-binary\fP ] +[ \fB--binary\fP ] .ad b .br .ad l -[ \fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ] +[ \fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ] .ad b .br .ad l -[ \fB\-\-foreign\fP ] +[ \fB--foreign\fP ] .ad b .br .ad l -[ \fB\-\-ignorelockingfailure\fP ] +[ \fB--ignorelockingfailure\fP ] .ad b .br .ad l -[ \fB\-\-ignoreskippedcluster\fP ] +[ \fB--ignoreskippedcluster\fP ] .ad b .br .ad l -[ \fB\-\-logonly\fP ] +[ \fB--logonly\fP ] .ad b .br .ad l -[ \fB\-\-nameprefixes\fP ] +[ \fB--nameprefixes\fP ] .ad b .br .ad l -[ \fB\-\-noheadings\fP ] +[ \fB--noheadings\fP ] .ad b .br .ad l -[ \fB\-\-nolocking\fP ] +[ \fB--nolocking\fP ] .ad b .br .ad l -[ \fB\-\-nosuffix\fP ] +[ \fB--nosuffix\fP ] .ad b .br .ad l -[ \fB\-\-readonly\fP ] +[ \fB--readonly\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br .ad l -[ \fB\-\-rows\fP ] +[ \fB--rows\fP ] .ad b .br .ad l -[ \fB\-\-separator\fP \fIString\fP ] +[ \fB--separator\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-shared\fP ] +[ \fB--shared\fP ] .ad b .br .ad l -[ \fB\-\-trustcache\fP ] +[ \fB--trustcache\fP ] .ad b .br .ad l -[ \fB\-\-unbuffered\fP ] +[ \fB--unbuffered\fP ] .ad b .br .ad l -[ \fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ] +[ \fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ] .ad b .br .ad l -[ \fB\-\-unquoted\fP ] +[ \fB--unquoted\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -126,69 +126,69 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-aligned\fP +\fB--aligned\fP .br -Use with \-\-separator to align the output columns +Use with --separator to align the output columns .ad b .HP .ad l -\fB-a\fP|\fB\-\-all\fP +\fB-a\fP|\fB--all\fP .br List all VGs. Equivalent to not specifying any VGs. .ad b .HP .ad l -\fB\-\-binary\fP +\fB--binary\fP .br Use binary values "0" or "1" instead of descriptive literal values for columns that have exactly two valid values to report (not counting @@ -196,14 +196,14 @@ the "unknown" value which denotes that the value could not be determined). .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -212,94 +212,94 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP +\fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP .br See lvmreport(7). .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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\-\-foreign\fP +\fB--foreign\fP .br Report/display foreign VGs that would otherwise be skipped. See lvmsystemid(7) for more information about foreign VGs. .ad b .HP .ad l -\fB-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-ignorelockingfailure\fP +\fB--ignorelockingfailure\fP .br Allows a command to continue with read-only metadata operations after locking failures. .ad b .HP .ad l -\fB\-\-ignoreskippedcluster\fP +\fB--ignoreskippedcluster\fP .br Use to avoid exiting with an non-zero status code if the command is run without clustered locking and clustered VGs are skipped. .ad b .HP .ad l -\fB\-\-logonly\fP +\fB--logonly\fP .br Suppress command report and display only log report. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-nameprefixes\fP +\fB--nameprefixes\fP .br Add an "LVM2_" prefix plus the field name to the output. Useful -with \-\-noheadings to produce a list of field=value pairs that can +with --noheadings to produce a list of field=value pairs that can be used to set environment variables (for example, in udev rules). .ad b .HP .ad l -\fB\-\-noheadings\fP +\fB--noheadings\fP .br Suppress the headings line that is normally the first line of output. Useful if grepping the output. .ad b .HP .ad l -\fB\-\-nolocking\fP +\fB--nolocking\fP .br Disable locking. .ad b .HP .ad l -\fB\-\-nosuffix\fP +\fB--nosuffix\fP .br -Suppress the suffix on output sizes. Use with \-\-units +Suppress the suffix on output sizes. Use with --units (except h and H) if processing the output. .ad b .HP .ad l -\fB-o\fP|\fB\-\-options\fP \fIString\fP +\fB-o\fP|\fB--options\fP \fIString\fP .br Comma-separated, ordered list of fields to display in columns. String arg syntax is: [+|-|#]Field1[,Field2 ...] @@ -321,7 +321,7 @@ See lvmreport(7) for more information about reporting. .ad b .HP .ad l -\fB-P\fP|\fB\-\-partial\fP +\fB-P\fP|\fB--partial\fP .br When set, the tools will do their best to provide access to VGs that are only partially available (one or more PVs belonging @@ -330,21 +330,21 @@ changed with this option. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-readonly\fP +\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 @@ -358,7 +358,7 @@ actually in use. .ad b .HP .ad l -\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -369,18 +369,18 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB\-\-rows\fP +\fB--rows\fP .br Output columns as rows. .ad b .HP .ad l -\fB-S\fP|\fB\-\-select\fP \fIString\fP +\fB-S\fP|\fB--select\fP \fIString\fP .br Select objects for processing and reporting based on specified criteria. -The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). +The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7). For reporting commands, one row is displayed for each object matching the criteria. -See \fB\-\-options help\fP for selectable object fields. +See \fB--options help\fP for selectable object fields. Rows can be displayed with an additional "selected" field (-o selected) showing 1 if the row matches the selection and 0 otherwise. For non-reporting commands which process LVM entities, the selection is @@ -388,13 +388,13 @@ used to choose items to process. .ad b .HP .ad l -\fB\-\-separator\fP \fIString\fP +\fB--separator\fP \fIString\fP .br String to use to separate each column. Useful if grepping the output. .ad b .HP .ad l -\fB\-\-shared\fP +\fB--shared\fP .br Report/display shared VGs that would otherwise be skipped when lvmlockd is not being used on the host. @@ -402,14 +402,14 @@ See lvmlockd(8) for more information about shared VGs. .ad b .HP .ad l -\fB-O\fP|\fB\-\-sort\fP \fIString\fP +\fB-O\fP|\fB--sort\fP \fIString\fP .br Comma-separated ordered list of columns to sort by. Replaces the default selection. Precede any column with \fB-\fP for a reverse sort on that column. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -419,50 +419,50 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB\-\-trustcache\fP +\fB--trustcache\fP .br Avoids certain device scanning during command processing. Do not use. .ad b .HP .ad l -\fB\-\-unbuffered\fP +\fB--unbuffered\fP .br Produce output immediately without sorting or aligning the columns properly. .ad b .HP .ad l -\fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP +\fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP .br All sizes are output in these units: human-(r)eadable with '<' rounding indicator, (h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes. Capitalise to use multiples of 1000 (S.I.) instead of 1024. -Custom units can be specified, e.g. \-\-units 3M. +Custom units can be specified, e.g. --units 3M. .ad b .HP .ad l -\fB\-\-unquoted\fP +\fB--unquoted\fP .br -When used with \-\-nameprefixes, output values in the field=value +When used with --nameprefixes, output values in the field=value pairs are not quoted. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -493,7 +493,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/vgscan.8_pregen b/man/vgscan.8_pregen index 072437307..011747c71 100644 --- a/man/vgscan.8_pregen +++ b/man/vgscan.8_pregen @@ -1,6 +1,6 @@ .TH VGSCAN 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -vgscan \- Search for all volume groups +vgscan - Search for all volume groups . .SH SYNOPSIS \fBvgscan\fP @@ -14,27 +14,27 @@ vgscan scans all supported LVM block devices in the system for VGs. .br .RS 4 .ad l -[ \fB-P\fP|\fB\-\-partial\fP ] +[ \fB-P\fP|\fB--partial\fP ] .ad b .br .ad l -[ \fB\-\-cache\fP ] +[ \fB--cache\fP ] .ad b .br .ad l -[ \fB\-\-ignorelockingfailure\fP ] +[ \fB--ignorelockingfailure\fP ] .ad b .br .ad l -[ \fB\-\-mknodes\fP ] +[ \fB--mknodes\fP ] .ad b .br .ad l -[ \fB\-\-notifydbus\fP ] +[ \fB--notifydbus\fP ] .ad b .br .ad l -[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] +[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ] .ad b .br [ COMMON_OPTIONS ] @@ -45,70 +45,70 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .ad l -\fB\-\-cache\fP +\fB--cache\fP .br Scan all devices and send the metadata to lvmetad. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -117,47 +117,47 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-ignorelockingfailure\fP +\fB--ignorelockingfailure\fP .br Allows a command to continue with read-only metadata operations after locking failures. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB\-\-mknodes\fP +\fB--mknodes\fP .br Also checks the LVM special files in /dev that are needed for active LVs and creates any missing ones and removes unused ones. .ad b .HP .ad l -\fB\-\-notifydbus\fP +\fB--notifydbus\fP .br Send a notification to D-Bus. The command will exit with an error if LVM is not built with support for D-Bus notification, or if the @@ -165,7 +165,7 @@ notify_dbus config setting is disabled. .ad b .HP .ad l -\fB-P\fP|\fB\-\-partial\fP +\fB-P\fP|\fB--partial\fP .br When set, the tools will do their best to provide access to VGs that are only partially available (one or more PVs belonging @@ -174,21 +174,21 @@ changed with this option. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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\-\-reportformat\fP \fBbasic\fP|\fBjson\fP +\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. @@ -199,7 +199,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information. .ad b .HP .ad l -\fB-t\fP|\fB\-\-test\fP +\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 @@ -209,20 +209,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -244,7 +244,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm. diff --git a/man/vgsplit.8_pregen b/man/vgsplit.8_pregen index bdd304b4f..98235eaf9 100644 --- a/man/vgsplit.8_pregen +++ b/man/vgsplit.8_pregen @@ -1,6 +1,6 @@ .TH VGSPLIT 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .SH NAME -vgsplit \- Move physical volumes into a new or existing volume group +vgsplit - Move physical volumes into a new or existing volume group . .SH SYNOPSIS \fBvgsplit\fP \fIoption_args\fP \fIposition_args\fP @@ -35,7 +35,7 @@ Split a VG by specified PVs. Split a VG by PVs in a specified LV. .br .P -\fBvgsplit\fP \fB-n\fP|\fB\-\-name\fP \fILV\fP \fIVG\fP \fIVG\fP +\fBvgsplit\fP \fB-n\fP|\fB--name\fP \fILV\fP \fIVG\fP \fIVG\fP .br .RS 4 [ COMMON_OPTIONS ] @@ -46,31 +46,31 @@ Common options for command: . .RS 4 .ad l -[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-c\fP|\fB\-\-clustered\fP \fBy\fP|\fBn\fP ] +[ \fB-c\fP|\fB--clustered\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB-l\fP|\fB\-\-maxlogicalvolumes\fP \fINumber\fP ] +[ \fB-l\fP|\fB--maxlogicalvolumes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-p\fP|\fB\-\-maxphysicalvolumes\fP \fINumber\fP ] +[ \fB-p\fP|\fB--maxphysicalvolumes\fP \fINumber\fP ] .ad b .br .ad l -[ \fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ] +[ \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ] .ad b .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 .ad l -[ \fB\-\-[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP ] +[ \fB--[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP ] .ad b .RE @@ -78,57 +78,57 @@ Common options for lvm: . .RS 4 .ad l -[ \fB-d\fP|\fB\-\-debug\fP ] +[ \fB-d\fP|\fB--debug\fP ] .ad b .br .ad l -[ \fB-h\fP|\fB\-\-help\fP ] +[ \fB-h\fP|\fB--help\fP ] .ad b .br .ad l -[ \fB-q\fP|\fB\-\-quiet\fP ] +[ \fB-q\fP|\fB--quiet\fP ] .ad b .br .ad l -[ \fB-t\fP|\fB\-\-test\fP ] +[ \fB-t\fP|\fB--test\fP ] .ad b .br .ad l -[ \fB-v\fP|\fB\-\-verbose\fP ] +[ \fB-v\fP|\fB--verbose\fP ] .ad b .br .ad l -[ \fB-y\fP|\fB\-\-yes\fP ] +[ \fB-y\fP|\fB--yes\fP ] .ad b .br .ad l -[ \fB\-\-commandprofile\fP \fIString\fP ] +[ \fB--commandprofile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-config\fP \fIString\fP ] +[ \fB--config\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] .ad b .br .ad l -[ \fB\-\-longhelp\fP ] +[ \fB--longhelp\fP ] .ad b .br .ad l -[ \fB\-\-profile\fP \fIString\fP ] +[ \fB--profile\fP \fIString\fP ] .ad b .br .ad l -[ \fB\-\-version\fP ] +[ \fB--version\fP ] .ad b .RE .SH OPTIONS .HP .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 .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 @@ -149,27 +149,27 @@ See \fBlvm\fP(8) for more information about allocation. .ad b .HP .ad l -\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP +\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 vgcfgbackup(8) for more information. .ad b .HP .ad l -\fB-c\fP|\fB\-\-clustered\fP \fBy\fP|\fBn\fP +\fB-c\fP|\fB--clustered\fP \fBy\fP|\fBn\fP .br Specifies the clustered property of the new VG. .ad b .HP .ad l -\fB\-\-commandprofile\fP \fIString\fP +\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\-\-config\fP \fIString\fP +\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, @@ -178,48 +178,48 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-d\fP|\fB\-\-debug\fP ... +\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\-\-driverloaded\fP \fBy\fP|\fBn\fP +\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-h\fP|\fB\-\-help\fP +\fB-h\fP|\fB--help\fP .br Display help text. .ad b .HP .ad l -\fB\-\-longhelp\fP +\fB--longhelp\fP .br Display long help text. .ad b .HP .ad l -\fB-l\fP|\fB\-\-maxlogicalvolumes\fP \fINumber\fP +\fB-l\fP|\fB--maxlogicalvolumes\fP \fINumber\fP .br Sets the maximum number of LVs allowed in a VG. .ad b .HP .ad l -\fB-p\fP|\fB\-\-maxphysicalvolumes\fP \fINumber\fP +\fB-p\fP|\fB--maxphysicalvolumes\fP \fINumber\fP .br Sets the maximum number of PVs that can belong to the VG. The value 0 removes any limitation. -For large numbers of PVs, also see options \-\-pvmetadatacopies, -and \-\-vgmetadatacopies for improving performance. +For large numbers of PVs, also see options --pvmetadatacopies, +and --vgmetadatacopies for improving performance. .ad b .HP .ad l -\fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP +\fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP .br Specifies the type of on-disk metadata to use. \fBlvm2\fP (or just \fB2\fP) is the current, standard format. @@ -228,27 +228,27 @@ can be used for accessing old data. .ad b .HP .ad l -\fB-n\fP|\fB\-\-name\fP \fIString\fP +\fB-n\fP|\fB--name\fP \fIString\fP .br Move only PVs used by the named LV. .ad b .HP .ad l -\fB\-\-profile\fP \fIString\fP +\fB--profile\fP \fIString\fP .br -An alias for \-\-commandprofile or \-\-metadataprofile, depending +An alias for --commandprofile or --metadataprofile, depending on the command. .ad b .HP .ad l -\fB-q\fP|\fB\-\-quiet\fP ... +\fB-q\fP|\fB--quiet\fP ... .br -Suppress output and log messages. Overrides \-\-debug and \-\-verbose. +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-t\fP|\fB\-\-test\fP +\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 @@ -258,20 +258,20 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB-v\fP|\fB\-\-verbose\fP ... +\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 +\fB--version\fP .br Display version information. .ad b .HP .ad l -\fB\-\-[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP +\fB--[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP .br Number of copies of the VG metadata that are kept. VG metadata is kept in VG metadata areas on PVs in the VG, @@ -289,7 +289,7 @@ all PVs, and then to become unmanaged. .ad b .HP .ad l -\fB-y\fP|\fB\-\-yes\fP +\fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. @@ -325,7 +325,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP. b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes, e|E is exabytes. -(This should not be confused with the output control \-\-units, where +(This should not be confused with the output control --units, where capital letters mean multiple of 1000.) .SH ENVIRONMENT VARIABLES See \fBlvm\fP(8) for information about environment variables used by lvm.