diff options
author | Marian Csontos <mcsontos@redhat.com> | 2019-06-14 12:14:41 +0200 |
---|---|---|
committer | Marian Csontos <mcsontos@redhat.com> | 2019-06-14 12:14:41 +0200 |
commit | ec4fa75cee77cfe310fa53386e57055afba719a6 (patch) | |
tree | 98e355644af833453b236e07fc4606c29dcf39ab | |
parent | a4dbbefaff74b6507c82dc1b938b0312c2dda576 (diff) | |
download | lvm2-dev-mcsontos-generate.tar.gz |
build: make generatedev-mcsontos-generate
-rw-r--r-- | conf/example.conf.in | 27 | ||||
-rw-r--r-- | man/lvchange.8_pregen | 293 | ||||
-rw-r--r-- | man/lvm-fullreport.8_pregen | 10 | ||||
-rw-r--r-- | man/lvs.8_pregen | 10 | ||||
-rw-r--r-- | man/pvchange.8_pregen | 35 | ||||
-rw-r--r-- | man/pvs.8_pregen | 10 | ||||
-rw-r--r-- | man/vgchange.8_pregen | 169 | ||||
-rw-r--r-- | man/vgck.8_pregen | 26 | ||||
-rw-r--r-- | man/vgs.8_pregen | 10 |
9 files changed, 52 insertions, 538 deletions
diff --git a/conf/example.conf.in b/conf/example.conf.in index a5eba014a..154f621bc 100644 --- a/conf/example.conf.in +++ b/conf/example.conf.in @@ -201,9 +201,34 @@ devices { multipath_component_detection = 1 # Configuration option devices/md_component_detection. - # Ignore devices that are components of software RAID (md) devices. + # Enable detection and exclusion of MD component devices. + # An MD component device is a block device that MD uses as part + # of a software RAID virtual device. When an LVM PV is created + # on an MD device, LVM must only use the top level MD device as + # the PV, and should ignore the underlying component devices. + # In cases where the MD superblock is located at the end of the + # component devices, it is more difficult for LVM to consistently + # identify an MD component, see the md_component_checks setting. md_component_detection = 1 + # Configuration option devices/md_component_checks. + # The checks LVM should use to detect MD component devices. + # MD component devices are block devices used by MD software RAID. + # + # Accepted values: + # auto + # LVM will skip scanning the end of devices when it has other + # indications that the device is not an MD component. + # start + # LVM will only scan the start of devices for MD superblocks. + # This does not incur extra I/O by LVM. + # full + # LVM will scan the start and end of devices for MD superblocks. + # This requires an extra read at the end of devices. + # + # This configuration option has an automatic default value. + # md_component_checks = "auto" + # Configuration option devices/fw_raid_component_detection. # Ignore devices that are components of firmware RAID devices. # LVM must use an external_device_info_source other than none for this diff --git a/man/lvchange.8_pregen b/man/lvchange.8_pregen index 110dd919f..8737a038c 100644 --- a/man/lvchange.8_pregen +++ b/man/lvchange.8_pregen @@ -17,74 +17,26 @@ lvchange - Change the attributes of logical volume(s) .ad b .br .ad l - \fB--addtag\fP \fITag\fP -.ad b -.br -.ad l - \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP -.ad b -.br -.ad l \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP -.ad b -.br -.ad l - \fB--cachepolicy\fP \fIString\fP -.ad b -.br -.ad l - \fB--cachesettings\fP \fIString\fP -.ad b -.br -.ad l \fB--commandprofile\fP \fIString\fP .ad b .br .ad l - \fB--compression\fP \fBy\fP|\fBn\fP -.ad b -.br -.ad l \fB--config\fP \fIString\fP .ad b .br .ad l - \fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP -.ad b -.br -.ad l \fB-d\fP|\fB--debug\fP .ad b .br .ad l - \fB--deduplication\fP \fBy\fP|\fBn\fP -.ad b -.br -.ad l - \fB--deltag\fP \fITag\fP -.ad b -.br -.ad l - \fB--detachprofile\fP -.ad b -.br -.ad l - \fB--discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP -.ad b -.br -.ad l \fB--driverloaded\fP \fBy\fP|\fBn\fP .ad b .br .ad l - \fB--errorwhenfull\fP \fBy\fP|\fBn\fP -.ad b -.br -.ad l \fB-f\fP|\fB--force\fP .ad b .br @@ -117,22 +69,10 @@ lvchange - Change the attributes of logical volume(s) .ad b .br .ad l - \fB--[raid]maxrecoveryrate\fP \fISize\fP[k|UNIT] -.ad b -.br -.ad l - \fB--metadataprofile\fP \fIString\fP -.ad b -.br -.ad l \fB--minor\fP \fINumber\fP .ad b .br .ad l - \fB--[raid]minrecoveryrate\fP \fISize\fP[k|UNIT] -.ad b -.br -.ad l \fB--monitor\fP \fBy\fP|\fBn\fP .ad b .br @@ -149,10 +89,6 @@ lvchange - Change the attributes of logical volume(s) .ad b .br .ad l - \fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP -.ad b -.br -.ad l \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP .ad b .br @@ -169,10 +105,6 @@ lvchange - Change the attributes of logical volume(s) .ad b .br .ad l - \fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP -.ad b -.br -.ad l \fB--readonly\fP .ad b .br @@ -197,10 +129,6 @@ lvchange - Change the attributes of logical volume(s) .ad b .br .ad l - \fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP -.ad b -.br -.ad l \fB--[raid]syncaction\fP \fBcheck\fP|\fBrepair\fP .ad b .br @@ -221,20 +149,8 @@ lvchange - Change the attributes of logical volume(s) .ad b .br .ad l - \fB--[raid]writebehind\fP \fINumber\fP -.ad b -.br -.ad l - \fB--[raid]writemostly\fP \fIPV\fP[\fB:t\fP|\fBn\fP|\fBy\fP] -.ad b -.br -.ad l \fB-y\fP|\fB--yes\fP .ad b -.br -.ad l - \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 kernel, and includes other utilities for LV maintenance. @@ -649,34 +565,6 @@ See \fBlvmraid\fP(7) for more information. .ad b .HP .ad l -\fB--addtag\fP \fITag\fP -.br -Adds a tag to a PV, VG or LV. This option can be repeated to add -multiple tags at once. See \fBlvm\fP(8) for information about tags. -.ad b -.HP -.ad l -\fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP -.br -Determines the allocation policy when a command needs to allocate -Physical Extents (PEs) from the VG. Each VG and LV has an allocation policy -which can be changed with vgchange/lvchange, or overriden on the -command line. -\fBnormal\fP applies common sense rules such as not placing parallel stripes -on the same PV. -\fBinherit\fP applies the VG policy to an LV. -\fBcontiguous\fP requires new PEs be placed adjacent to existing PEs. -\fBcling\fP places new PEs on the same PV as existing PEs in the same -stripe of the LV. -If there are sufficient PEs for an allocation, but normal does not -use them, \fBanywhere\fP will use them even if it reduces performance, -e.g. by placing two stripes on the same PV. -Optional positional PV args on the command line can also be used to limit -which PVs the command will use for allocation. -See \fBlvm\fP(8) for more information about allocation. -.ad b -.HP -.ad l \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP .br Specifies if metadata should be backed up automatically after a change. @@ -684,41 +572,6 @@ Enabling this is strongly advised! See \fBvgcfgbackup\fP(8) for more information .ad b .HP .ad l -\fB--cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP -.br -Specifies when writes to a cache LV should be considered complete. -\fBwriteback\fP considers a write complete as soon as it is -stored in the cache pool. -\fBwritethough\fP considers a write complete only when it has -been stored in both the cache pool and on the origin LV. -While writethrough may be slower for writes, it is more -resilient if something should happen to a device associated with the -cache pool LV. With \fBpassthrough\fP, all reads are served -from the origin LV (all reads miss the cache) and all writes are -forwarded to the origin LV; additionally, write hits cause cache -block invalidates. See \fBlvmcache\fP(7) for more information. -.ad b -.HP -.ad l -\fB--cachepolicy\fP \fIString\fP -.br -Specifies the cache policy for a cache LV. -See \fBlvmcache\fP(7) for more information. -.ad b -.HP -.ad l -\fB--cachesettings\fP \fIString\fP -.br -Specifies tunable values for a cache LV in "Key = Value" form. -Repeat this option to specify multiple values. -(The default values should usually be adequate.) -The special string value \fBdefault\fP switches -settings back to their default kernel values and removes -them from the list of settings stored in LVM metadata. -See \fBlvmcache\fP(7) for more information. -.ad b -.HP -.ad l \fB--commandprofile\fP \fIString\fP .br The command profile to use for command configuration. @@ -726,13 +579,6 @@ See \fBlvm.conf\fP(5) for more information about profiles. .ad b .HP .ad l -\fB--compression\fP \fBy\fP|\fBn\fP -.br -Controls whether compression is enabled or disable for VDO volume. -See \fBlvmvdo\fP(7) for more information about VDO usage. -.ad b -.HP -.ad l \fB--config\fP \fIString\fP .br Config settings for the command. These override lvm.conf settings. @@ -742,16 +588,6 @@ See \fBlvm.conf\fP(5) for more information about config. .ad b .HP .ad l -\fB-C\fP|\fB--contiguous\fP \fBy\fP|\fBn\fP -.br -Sets or resets the contiguous allocation policy for LVs. -Default is no contiguous allocation based on a next free principle. -It is only possible to change a non-contiguous allocation policy -to contiguous if all of the allocated physical extents in the LV -are already contiguous. -.ad b -.HP -.ad l \fB-d\fP|\fB--debug\fP ... .br Set debug level. Repeat from 1 to 6 times to increase the detail of @@ -759,40 +595,6 @@ messages sent to the log file and/or syslog (if configured). .ad b .HP .ad l -\fB--deduplication\fP \fBy\fP|\fBn\fP -.br -Controls whether deduplication is enabled or disable for VDO volume. -See \fBlvmvdo\fP(7) for more information about VDO usage. -.ad b -.HP -.ad l -\fB--deltag\fP \fITag\fP -.br -Deletes a tag from a PV, VG or LV. This option can be repeated to delete -multiple tags at once. See \fBlvm\fP(8) for information about tags. -.ad b -.HP -.ad l -\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 -.br -Specifies how the device-mapper thin pool layer in the kernel should -handle discards. -\fBignore\fP causes the thin pool to ignore discards. -\fBnopassdown\fP causes the thin pool to process discards itself to -allow reuse of unneeded extents in the thin pool. -\fBpassdown\fP causes the thin pool to process discards itself -(like nopassdown) and pass the discards to the underlying device. -See \fBlvmthin\fP(7) for more information. -.ad b -.HP -.ad l \fB--driverloaded\fP \fBy\fP|\fBn\fP .br If set to no, the command will not attempt to use device-mapper. @@ -800,19 +602,6 @@ For testing and debugging. .ad b .HP .ad l -\fB--errorwhenfull\fP \fBy\fP|\fBn\fP -.br -Specifies thin pool behavior when data space is exhausted. -When yes, device-mapper will immediately return an error -when a thin pool is full and an I/O request requires space. -When no, device-mapper will queue these I/O requests for a -period of time to allow the thin pool to be extended. -Errors are returned if no space is available after the timeout. -(Also see dm-thin-pool kernel module option no_space_timeout.) -See \fBlvmthin\fP(7) for more information. -.ad b -.HP -.ad l \fB-f\fP|\fB--force\fP ... .br Override various checks, confirmations and protections. @@ -866,37 +655,12 @@ Sets the major number of an LV block device. .ad b .HP .ad l -\fB--[raid]maxrecoveryrate\fP \fISize\fP[k|UNIT] -.br -Sets the maximum recovery rate for a RAID LV. The rate value -is an amount of data per second for each device in the array. -Setting the rate to 0 means it will be unbounded. -See \fBlvmraid\fP(7) for more information. -.ad b -.HP -.ad l -\fB--metadataprofile\fP \fIString\fP -.br -The metadata profile to use for command configuration. -See \fBlvm.conf\fP(5) for more information about profiles. -.ad b -.HP -.ad l \fB--minor\fP \fINumber\fP .br Sets the minor number of an LV block device. .ad b .HP .ad l -\fB--[raid]minrecoveryrate\fP \fISize\fP[k|UNIT] -.br -Sets the minimum recovery rate for a RAID LV. The rate value -is an amount of data per second for each device in the array. -Setting the rate to 0 means it will be unbounded. -See \fBlvmraid\fP(7) for more information. -.ad b -.HP -.ad l \fB--monitor\fP \fBy\fP|\fBn\fP .br Start (yes) or stop (no) monitoring an LV with dmeventd. @@ -930,12 +694,6 @@ Metadata may not be changed with this option. .ad b .HP .ad l -\fB-p\fP|\fB--permission\fP \fBrw\fP|\fBr\fP -.br -Set access permission to read only \fBr\fP or read and write \fBrw\fP. -.ad b -.HP -.ad l \fB-M\fP|\fB--persistent\fP \fBy\fP|\fBn\fP .br When yes, makes the specified minor number persistent. @@ -968,15 +726,6 @@ Repeat once to also suppress any prompts with answer 'no'. .ad b .HP .ad l -\fB-r\fP|\fB--readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP -.br -Sets read ahead sector count of an LV. -\fBauto\fP is the default which allows the kernel to choose -a suitable value automatically. -\fBnone\fP is equivalent to zero. -.ad b -.HP -.ad l \fB--readonly\fP .br Run the command in a special read-only mode which will read on-disk @@ -1044,17 +793,6 @@ used to choose items to process. .ad b .HP .ad l -\fB-k\fP|\fB--setactivationskip\fP \fBy\fP|\fBn\fP -.br -Persistently sets (yes) or clears (no) the "activation skip" flag on an LV. -An LV with this flag set is not activated unless the ---ignoreactivationskip option is used by the activation command. -This flag is set by default on new thin snapshot LVs. -The flag is not applied to deactivation. -The current value of the flag is indicated in the lvs lv_attr bits. -.ad b -.HP -.ad l \fB--[raid]syncaction\fP \fBcheck\fP|\fBrepair\fP .br Initiate different types of RAID synchronization. @@ -1102,43 +840,12 @@ Display version information. .ad b .HP .ad l -\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. -Once this value is exceeded, writes become synchronous (i.e. all writes -to the constituent devices must complete before the array signals the -write has completed). Setting the value to zero clears the preference -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] -.br -Mark a device in a RAID1 LV as write-mostly. All reads -to these drives will be avoided unless absolutely necessary. This keeps -the number of I/Os to the drive to a minimum. The default behavior is to -set the write-mostly attribute for the specified PV. -It is also possible to remove the write-mostly flag by adding the -suffix \fB:n\fP at the end of the PV name, or to toggle the value with -the suffix \fB:t\fP. Repeat this option to change the attribute on -multiple PVs. -.ad b -.HP -.ad l \fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the answer yes. Use with extreme caution. (For automatic no, see -qq.) .ad b -.HP -.ad l -\fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP -.br -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. -.ad b .SH VARIABLES .HP \fIVG\fP diff --git a/man/lvm-fullreport.8_pregen b/man/lvm-fullreport.8_pregen index 1170dc7ee..07e618a82 100644 --- a/man/lvm-fullreport.8_pregen +++ b/man/lvm-fullreport.8_pregen @@ -92,10 +92,6 @@ if information changes between commands. .ad b .br .ad l -[ \fB--trustcache\fP ] -.ad b -.br -.ad l [ \fB--unbuffered\fP ] .ad b .br @@ -406,12 +402,6 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB--trustcache\fP -.br -Avoids certain device scanning during command processing. Do not use. -.ad b -.HP -.ad l \fB--unbuffered\fP .br Produce output immediately without sorting or aligning the columns properly. diff --git a/man/lvs.8_pregen b/man/lvs.8_pregen index c92ba1410..8c3091dee 100644 --- a/man/lvs.8_pregen +++ b/man/lvs.8_pregen @@ -96,10 +96,6 @@ lvs produces formatted output about LVs. .ad b .br .ad l -[ \fB--trustcache\fP ] -.ad b -.br -.ad l [ \fB--unbuffered\fP ] .ad b .br @@ -427,12 +423,6 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB--trustcache\fP -.br -Avoids certain device scanning during command processing. Do not use. -.ad b -.HP -.ad l \fB--unbuffered\fP .br Produce output immediately without sorting or aligning the columns properly. diff --git a/man/pvchange.8_pregen b/man/pvchange.8_pregen index c21ce70fa..de34e1526 100644 --- a/man/pvchange.8_pregen +++ b/man/pvchange.8_pregen @@ -16,7 +16,7 @@ others are optional. Change properties of all PVs. .br .P -\fBpvchange\fP +\fBpvchange\fP \fB-a\fP|\fB--all\fP .RS 4 ( \fB-x\fP|\fB--allocatable\fP \fBy\fP|\fBn\fP, .ad b @@ -26,10 +26,6 @@ Change properties of all PVs. .ad b .br .ad l - \fB-a\fP|\fB--all\fP, -.ad b -.br -.ad l \fB--addtag\fP \fITag\fP, .ad b .br @@ -164,25 +160,12 @@ Common options for lvm: .SH OPTIONS .HP .ad l -\fB--addtag\fP \fITag\fP -.br -Adds a tag to a PV, VG or LV. This option can be repeated to add -multiple tags at once. See \fBlvm\fP(8) for information about tags. -.ad b -.HP -.ad l \fB-a\fP|\fB--all\fP .br Change all visible PVs. .ad b .HP .ad l -\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 .br Specifies if metadata should be backed up automatically after a change. @@ -213,13 +196,6 @@ messages sent to the log file and/or syslog (if configured). .ad b .HP .ad l -\fB--deltag\fP \fITag\fP -.br -Deletes a tag from a PV, VG or LV. This option can be repeated to delete -multiple tags at once. See \fBlvm\fP(8) for information about tags. -.ad b -.HP -.ad l \fB--driverloaded\fP \fBy\fP|\fBn\fP .br If set to no, the command will not attempt to use device-mapper. @@ -253,15 +229,6 @@ Display long help text. .ad b .HP .ad l -\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 -not store metadata in the metadata areas of the PV. -If no, lvm will store metadata on the PV. -.ad b -.HP -.ad l \fB--nolocking\fP .br Disable locking. diff --git a/man/pvs.8_pregen b/man/pvs.8_pregen index 1902f2996..596f593af 100644 --- a/man/pvs.8_pregen +++ b/man/pvs.8_pregen @@ -92,10 +92,6 @@ pvs produces formatted output about PVs. .ad b .br .ad l -[ \fB--trustcache\fP ] -.ad b -.br -.ad l [ \fB--unbuffered\fP ] .ad b .br @@ -416,12 +412,6 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB--trustcache\fP -.br -Avoids certain device scanning during command processing. Do not use. -.ad b -.HP -.ad l \fB--unbuffered\fP .br Produce output immediately without sorting or aligning the columns properly. diff --git a/man/vgchange.8_pregen b/man/vgchange.8_pregen index 10cf8a7ae..2b1ed807a 100644 --- a/man/vgchange.8_pregen +++ b/man/vgchange.8_pregen @@ -19,14 +19,6 @@ vgchange - Change volume group attributes .ad b .br .ad l - \fB--addtag\fP \fITag\fP -.ad b -.br -.ad l - \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP -.ad b -.br -.ad l \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP .ad b .br @@ -43,14 +35,6 @@ vgchange - Change volume group attributes .ad b .br .ad l - \fB--deltag\fP \fITag\fP -.ad b -.br -.ad l - \fB--detachprofile\fP -.ad b -.br -.ad l \fB--driverloaded\fP \fBy\fP|\fBn\fP .ad b .br @@ -91,22 +75,10 @@ vgchange - Change volume group attributes .ad b .br .ad l - \fB-l\fP|\fB--logicalvolume\fP \fINumber\fP -.ad b -.br -.ad l \fB--longhelp\fP .ad b .br .ad l - \fB-p\fP|\fB--maxphysicalvolumes\fP \fINumber\fP -.ad b -.br -.ad l - \fB--metadataprofile\fP \fIString\fP -.ad b -.br -.ad l \fB--monitor\fP \fBy\fP|\fBn\fP .ad b .br @@ -123,10 +95,6 @@ vgchange - Change volume group attributes .ad b .br .ad l - \fB-s\fP|\fB--physicalextentsize\fP \fISize\fP[m|UNIT] -.ad b -.br -.ad l \fB--poll\fP \fBy\fP|\fBn\fP .ad b .br @@ -135,10 +103,6 @@ vgchange - Change volume group attributes .ad b .br .ad l - \fB--pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP -.ad b -.br -.ad l \fB-q\fP|\fB--quiet\fP .ad b .br @@ -155,10 +119,6 @@ vgchange - Change volume group attributes .ad b .br .ad l - \fB-x\fP|\fB--resizeable\fP \fBy\fP|\fBn\fP -.ad b -.br -.ad l \fB-S\fP|\fB--select\fP \fIString\fP .ad b .br @@ -175,10 +135,6 @@ vgchange - Change volume group attributes .ad b .br .ad l - \fB-u\fP|\fB--uuid\fP -.ad b -.br -.ad l \fB-v\fP|\fB--verbose\fP .ad b .br @@ -187,10 +143,6 @@ vgchange - Change volume group attributes .ad b .br .ad l - \fB--[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP -.ad b -.br -.ad l \fB-y\fP|\fB--yes\fP .ad b .SH DESCRIPTION @@ -670,34 +622,6 @@ See \fBlvmraid\fP(7) for more information. .ad b .HP .ad l -\fB--addtag\fP \fITag\fP -.br -Adds a tag to a PV, VG or LV. This option can be repeated to add -multiple tags at once. See \fBlvm\fP(8) for information about tags. -.ad b -.HP -.ad l -\fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP -.br -Determines the allocation policy when a command needs to allocate -Physical Extents (PEs) from the VG. Each VG and LV has an allocation policy -which can be changed with vgchange/lvchange, or overriden on the -command line. -\fBnormal\fP applies common sense rules such as not placing parallel stripes -on the same PV. -\fBinherit\fP applies the VG policy to an LV. -\fBcontiguous\fP requires new PEs be placed adjacent to existing PEs. -\fBcling\fP places new PEs on the same PV as existing PEs in the same -stripe of the LV. -If there are sufficient PEs for an allocation, but normal does not -use them, \fBanywhere\fP will use them even if it reduces performance, -e.g. by placing two stripes on the same PV. -Optional positional PV args on the command line can also be used to limit -which PVs the command will use for allocation. -See \fBlvm\fP(8) for more information about allocation. -.ad b -.HP -.ad l \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP .br Specifies if metadata should be backed up automatically after a change. @@ -728,20 +652,6 @@ messages sent to the log file and/or syslog (if configured). .ad b .HP .ad l -\fB--deltag\fP \fITag\fP -.br -Deletes a tag from a PV, VG or LV. This option can be repeated to delete -multiple tags at once. See \fBlvm\fP(8) for information about tags. -.ad b -.HP -.ad l -\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 .br If set to no, the command will not attempt to use device-mapper. @@ -813,34 +723,12 @@ See \fBlvmlockd\fP(8) for more information. .ad b .HP .ad l -\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 .br Display long help text. .ad b .HP .ad l -\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. -.ad b -.HP -.ad l -\fB--metadataprofile\fP \fIString\fP -.br -The metadata profile to use for command configuration. -See \fBlvm.conf\fP(5) for more information about profiles. -.ad b -.HP -.ad l \fB--monitor\fP \fBy\fP|\fBn\fP .br Start (yes) or stop (no) monitoring an LV with dmeventd. @@ -874,20 +762,6 @@ Metadata may not be changed with this option. .ad b .HP .ad l -\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 -(where the sector size is the largest sector size of the PVs -currently used in the VG), or at least 128KiB. -Once this value has been set, it is difficult to change -without recreating the VG, unless no extents need moving. -Before increasing the physical extent size, you might need to use lvresize, -pvresize and/or pvmove so that everything fits. For example, every -contiguous range of extents used in a LV must start and end on an extent boundary. -.ad b -.HP -.ad l \fB--poll\fP \fBy\fP|\fBn\fP .br When yes, start the background transformation of an LV. @@ -907,18 +781,6 @@ on the command. .ad b .HP .ad l -\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 -and a second copy is stored at the end. -When 1, one copy of the VG metadata is stored at the front of the PV. -When 0, no copies of the VG metadata are stored on the given PV. -This may be useful in VGs containing many PVs (this places limitations -on the ability to use vgsplit later.) -.ad b -.HP -.ad l \fB-q\fP|\fB--quiet\fP ... .br Suppress output and log messages. Overrides --debug and --verbose. @@ -957,13 +819,6 @@ 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 -.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 .br Select objects for processing and reporting based on specified criteria. @@ -1008,12 +863,6 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\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 ... .br Set verbose level. Repeat from 1 to 4 times to increase the detail @@ -1027,24 +876,6 @@ Display version information. .ad b .HP .ad l -\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, -i.e. reserved space at the start and/or end of the PVs. -Keeping a copy of the VG metadata on every PV can reduce performance -in VGs containing a large number of PVs. -When this number is set to a non-zero value, LVM will automatically -choose PVs on which to store metadata, using the metadataignore flags -on PVs to achieve the specified number. -The number can also be replaced with special string values: -\fBunmanaged\fP causes LVM to not automatically manage the PV -metadataignore flags. -\fBall\fP causes LVM to first clear the metadataignore flags on -all PVs, and then to become unmanaged. -.ad b -.HP -.ad l \fB-y\fP|\fB--yes\fP .br Do not prompt for confirmation interactively but always assume the diff --git a/man/vgck.8_pregen b/man/vgck.8_pregen index 4f2a86644..a66de5d7f 100644 --- a/man/vgck.8_pregen +++ b/man/vgck.8_pregen @@ -3,7 +3,7 @@ vgck - Check the consistency of volume group(s) . .SH SYNOPSIS -\fBvgck\fP +\fBvgck\fP \fIoption_args\fP \fIposition_args\fP .br [ \fIoption_args\fP ] .br @@ -12,6 +12,9 @@ vgck - Check the consistency of volume group(s) .SH DESCRIPTION vgck checks LVM metadata for consistency. .SH USAGE +Read and display information about a VG. +.br +.P \fBvgck\fP .br .RS 4 @@ -26,6 +29,21 @@ vgck checks LVM metadata for consistency. [ \fIVG\fP|\fITag\fP ... ] .RE +Rewrite VG metadata to correct problems. +.br +.P +\fBvgck\fP \fB--updatemetadata\fP \fIVG\fP +.br +.RS 4 +[ COMMON_OPTIONS ] +.RE +.br + +Common options for command: +. +.RS 4 +.RE + Common options for lvm: . .RS 4 @@ -178,6 +196,12 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l +\fB--updatemetadata\fP +.br +Update VG metadata to correct problems. +.ad b +.HP +.ad l \fB-v\fP|\fB--verbose\fP ... .br Set verbose level. Repeat from 1 to 4 times to increase the detail diff --git a/man/vgs.8_pregen b/man/vgs.8_pregen index 7ba7b8c71..8726909f7 100644 --- a/man/vgs.8_pregen +++ b/man/vgs.8_pregen @@ -88,10 +88,6 @@ vgs produces formatted output about VGs. .ad b .br .ad l -[ \fB--trustcache\fP ] -.ad b -.br -.ad l [ \fB--unbuffered\fP ] .ad b .br @@ -403,12 +399,6 @@ back metadata it believes has changed but hasn't. .ad b .HP .ad l -\fB--trustcache\fP -.br -Avoids certain device scanning during command processing. Do not use. -.ad b -.HP -.ad l \fB--unbuffered\fP .br Produce output immediately without sorting or aligning the columns properly. |