summaryrefslogtreecommitdiff
path: root/man/lvextend.8_pregen
diff options
context:
space:
mode:
authorZdenek Kabelac <zkabelac@redhat.com>2021-04-08 21:08:48 +0200
committerZdenek Kabelac <zkabelac@redhat.com>2021-04-12 09:54:16 +0200
commit151377dd50b7ba84894f799d9e0957898748f882 (patch)
tree4418362e7f94eaea06b2015c8b9ad60400d9dcb9 /man/lvextend.8_pregen
parent19ff0d983ee013711b88b66acc625a532f31b22b (diff)
downloadlvm2-151377dd50b7ba84894f799d9e0957898748f882.tar.gz
make: generate
Diffstat (limited to 'man/lvextend.8_pregen')
-rw-r--r--man/lvextend.8_pregen289
1 files changed, 155 insertions, 134 deletions
diff --git a/man/lvextend.8_pregen b/man/lvextend.8_pregen
index cf7925ee0..a4a90994d 100644
--- a/man/lvextend.8_pregen
+++ b/man/lvextend.8_pregen
@@ -11,7 +11,10 @@ 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
+.nh
+\fBcontiguous\fP|\:\fBcling\fP|\:\fBcling_by_tags\fP|\:\fBnormal\fP|\:\fBanywhere\fP|\:\fBinherit\fP
+.hy
.ad b
.br
.ad l
@@ -119,7 +122,10 @@ lvextend - Add space to a logical volume
.ad b
.br
.ad l
- \fB--type\fP \fBlinear\fP|\fBstriped\fP|\fBsnapshot\fP|\fBraid\fP|\fBmirror\fP|\fBthin\fP|\fBthin-pool\fP|\fBvdo\fP|\fBvdo-pool\fP|\fBcache\fP|\fBcache-pool\fP|\fBwritecache\fP
+ \fB--type\fP
+.nh
+\fBlinear\fP|\:\fBstriped\fP|\:\fBsnapshot\fP|\:\fBraid\fP|\:\fBmirror\fP|\:\fBthin\fP|\:\fBthin-pool\fP|\:\fBvdo\fP|\:\fBvdo-pool\fP|\:\fBcache\fP|\:\fBcache-pool\fP|\:\fBwritecache\fP
+.hy
.ad b
.br
.ad l
@@ -268,7 +274,11 @@ Common options for command:
.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
+.nh
+\fBcontiguous\fP|\:\fBcling\fP|\:\fBcling_by_tags\fP|\:\fBnormal\fP|\:\fBanywhere\fP|\:\fBinherit\fP
+.hy
+]
.ad b
.br
.ad l
@@ -284,7 +294,11 @@ Common options for command:
.ad b
.br
.ad l
-[ \fB--type\fP \fBlinear\fP|\fBstriped\fP|\fBsnapshot\fP|\fBraid\fP|\fBmirror\fP|\fBthin\fP|\fBthin-pool\fP|\fBvdo\fP|\fBvdo-pool\fP|\fBcache\fP|\fBcache-pool\fP|\fBwritecache\fP ]
+[ \fB--type\fP
+.nh
+\fBlinear\fP|\:\fBstriped\fP|\:\fBsnapshot\fP|\:\fBraid\fP|\:\fBmirror\fP|\:\fBthin\fP|\:\fBthin-pool\fP|\:\fBvdo\fP|\:\fBvdo-pool\fP|\:\fBcache\fP|\:\fBcache-pool\fP|\:\fBwritecache\fP
+.hy
+]
.ad b
.RE
@@ -356,10 +370,14 @@ Common options for lvm:
.ad b
.RE
.SH OPTIONS
-.HP
+.TP
.ad l
-\fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP
+\fB--alloc\fP
+.nh
+\fBcontiguous\fP|\:\fBcling\fP|\:\fBcling_by_tags\fP|\:\fBnormal\fP|\:\fBanywhere\fP|\:\fBinherit\fP
+.hy
.br
+.ad b
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 overridden on the
@@ -376,66 +394,66 @@ 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
+.TP
.ad l
\fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
.br
+.ad b
Specifies if metadata should be backed up automatically after a change.
Enabling this is strongly advised! See \fBvgcfgbackup\fP(8) for more information.
-.ad b
-.HP
+.TP
.ad l
\fB--commandprofile\fP \fIString\fP
.br
+.ad b
The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles.
-.ad b
-.HP
+.TP
.ad l
\fB--config\fP \fIString\fP
.br
+.ad b
Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf,
or may use section/field syntax.
See \fBlvm.conf\fP(5) for more information about config.
-.ad b
-.HP
+.TP
.ad l
\fB-d\fP|\fB--debug\fP ...
.br
+.ad b
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
+.TP
.ad l
\fB--devices\fP \fIPV\fP
.br
+.ad b
Devices that the command can use. This option can be repeated
or accepts a comma separated list of devices. This overrides
the devices file.
-.ad b
-.HP
+.TP
.ad l
\fB--devicesfile\fP \fIString\fP
.br
+.ad b
A file listing devices that LVM should use.
The file must exist in /etc/lvm/devices/ and is managed
with the lvmdevices(8) command.
This overrides the lvm.conf devices/devicesfile and
devices/use_devicesfile settings.
-.ad b
-.HP
+.TP
.ad l
\fB--driverloaded\fP \fBy\fP|\fBn\fP
.br
+.ad b
If set to no, the command will not attempt to use device-mapper.
For testing and debugging.
-.ad b
-.HP
+.TP
.ad l
\fB-l\fP|\fB--extents\fP [\fB+\fP]\fINumber\fP[PERCENT]
.br
+.ad b
Specifies the new size of the LV in logical extents.
The --size and --extents options are alternate methods of specifying size.
The total number of physical extents used will be
@@ -454,57 +472,57 @@ extents in the new LV is not determined until the command has completed.
When the plus \fB+\fP or minus \fB-\fP prefix is used,
the value is not an absolute size, but is relative and added or subtracted
from the current size.
-.ad b
-.HP
+.TP
.ad l
\fB-f\fP|\fB--force\fP ...
.br
+.ad b
Override various checks, confirmations and protections.
Use with extreme caution.
-.ad b
-.HP
+.TP
.ad l
\fB-h\fP|\fB--help\fP
.br
-Display help text.
.ad b
-.HP
+Display help text.
+.TP
.ad l
\fB--lockopt\fP \fIString\fP
.br
+.ad b
Used to pass options for special cases to lvmlockd.
See \fBlvmlockd\fP(8) for more information.
-.ad b
-.HP
+.TP
.ad l
\fB--longhelp\fP
.br
-Display long help text.
.ad b
-.HP
+Display long help text.
+.TP
.ad l
\fB-m\fP|\fB--mirrors\fP \fINumber\fP
.br
-Not used.
.ad b
-.HP
+Not used.
+.TP
.ad l
\fB-n\fP|\fB--nofsck\fP
.br
+.ad b
Do not perform fsck before resizing filesystem when filesystem
requires it. You may need to use --force to proceed with
this option.
-.ad b
-.HP
+.TP
.ad l
\fB--nolocking\fP
.br
-Disable locking.
.ad b
-.HP
+Disable locking.
+.TP
.ad l
\fB--nosync\fP
.br
+.ad b
Causes the creation of mirror, raid1, raid4, raid5 and raid10 to skip the
initial synchronization. In case of mirror, raid1 and raid10, any data
written afterwards will be mirrored, but the original contents will not be
@@ -517,59 +535,59 @@ This option is not valid for raid6, because raid6 relies on proper parity
to reconstruct proper user date in case of device failures.
raid0 and raid0_meta do not provide any data copies or parity support
and thus do not support initial synchronization.
-.ad b
-.HP
+.TP
.ad l
\fB--noudevsync\fP
.br
+.ad b
Disables udev synchronisation. The process will not wait for notification
from udev. It will continue irrespective of any possible udev processing
in the background. Only use this if udev is not running or has rules that
ignore the devices LVM creates.
-.ad b
-.HP
+.TP
.ad l
\fB--poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT]
.br
+.ad b
Specifies the new size of the pool metadata LV.
The plus prefix \fB+\fP can be used, in which case
the value is added to the current size.
-.ad b
-.HP
+.TP
.ad l
\fB--profile\fP \fIString\fP
.br
+.ad b
An alias for --commandprofile or --metadataprofile, depending
on the command.
-.ad b
-.HP
+.TP
.ad l
\fB-q\fP|\fB--quiet\fP ...
.br
+.ad b
Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer 'no'.
-.ad b
-.HP
+.TP
.ad l
\fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br
+.ad b
Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf.
\fBbasic\fP is the original format with columns and rows.
If there is more than one report per command, each report is prefixed
with the report name for identification. \fBjson\fP produces report
output in JSON format. See \fBlvmreport\fP(7) for more information.
-.ad b
-.HP
+.TP
.ad l
\fB-r\fP|\fB--resizefs\fP
.br
-Resize underlying filesystem together with the LV using fsadm(8).
.ad b
-.HP
+Resize underlying filesystem together with the LV using fsadm(8).
+.TP
.ad l
\fB-L\fP|\fB--size\fP [\fB+\fP]\fISize\fP[m|UNIT]
.br
+.ad b
Specifies the new size of the LV.
The --size and --extents options are alternate methods of specifying size.
The total number of physical extents used will be
@@ -577,11 +595,11 @@ greater when redundant data is needed for RAID levels.
When the plus \fB+\fP or minus \fB-\fP prefix is used,
the value is not an absolute size, but is relative and added or subtracted
from the current size.
-.ad b
-.HP
+.TP
.ad l
\fB-i\fP|\fB--stripes\fP \fINumber\fP
.br
+.ad b
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
@@ -594,28 +612,31 @@ when unspecified, the default depends on the RAID type
(raid0: 2, raid10: 2, raid4/5: 3, raid6: 5.)
To stripe a new raid LV across all PVs by default,
see lvm.conf allocation/raid_stripe_all_devices.
-.ad b
-.HP
+.TP
.ad l
\fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT]
.br
+.ad b
The amount of data that is written to one device before
moving to the next in a striped LV.
-.ad b
-.HP
+.TP
.ad l
\fB-t\fP|\fB--test\fP
.br
+.ad b
Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless
returning success to the calling function. This may lead to unusual
error messages in multi-stage operations if a tool relies on reading
back metadata it believes has changed but hasn't.
-.ad b
-.HP
+.TP
.ad l
-\fB--type\fP \fBlinear\fP|\fBstriped\fP|\fBsnapshot\fP|\fBraid\fP|\fBmirror\fP|\fBthin\fP|\fBthin-pool\fP|\fBvdo\fP|\fBvdo-pool\fP|\fBcache\fP|\fBcache-pool\fP|\fBwritecache\fP
+\fB--type\fP
+.nh
+\fBlinear\fP|\:\fBstriped\fP|\:\fBsnapshot\fP|\:\fBraid\fP|\:\fBmirror\fP|\:\fBthin\fP|\:\fBthin-pool\fP|\:\fBvdo\fP|\:\fBvdo-pool\fP|\:\fBcache\fP|\:\fBcache-pool\fP|\:\fBwritecache\fP
+.hy
.br
+.ad b
The LV type, also known as "segment type" or "segtype".
See usage descriptions for the specific ways to use these types.
For more information about redundancy and performance (\fBraid\fP<N>, \fBmirror\fP, \fBstriped\fP, \fBlinear\fP) see \fBlvmraid\fP(7).
@@ -627,44 +648,43 @@ 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, --vdo).
Use inferred types with care because it can lead to unexpected results.
-.ad b
-.HP
+.TP
.ad l
\fB--usepolicies\fP
.br
+.ad b
Perform an operation according to the policy configured in lvm.conf
or a profile.
-.ad b
-.HP
+.TP
.ad l
\fB-v\fP|\fB--verbose\fP ...
.br
+.ad b
Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr.
-.ad b
-.HP
+.TP
.ad l
\fB--version\fP
.br
-Display version information.
.ad b
-.HP
+Display version information.
+.TP
.ad l
\fB-y\fP|\fB--yes\fP
.br
+.ad b
Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution.
(For automatic no, see -qq.)
-.ad b
.SH VARIABLES
-.HP
+.TP
\fILV\fP
.br
Logical Volume name. See \fBlvm\fP(8) for valid names.
An LV positional arg generally includes the VG name and LV name, e.g. VG/LV.
LV followed by _<type> indicates that an LV of the
given type is required. (raid represents raid<N> type)
-.HP
+.TP
\fIPV\fP
.br
Physical Volume name, a device path under /dev.
@@ -674,11 +694,11 @@ of physical extents (PEs). When the first PE is omitted, it defaults
to the start of the device, and when the last PE is omitted it defaults to end.
Start and end range (inclusive): \fIPV\fP[\fB:\fP\fIPE\fP\fB-\fP\fIPE\fP]...
Start and length range (counting from 0): \fIPV\fP[\fB:\fP\fIPE\fP\fB+\fP\fIPE\fP]...
-.HP
+.TP
\fIString\fP
.br
See the option description for information about the string content.
-.HP
+.TP
\fISize\fP[UNIT]
.br
Size is an input number that accepts an optional unit.
@@ -708,70 +728,71 @@ Extend an LV by 16MiB using specific physical extents.
.br
.B lvextend -L+16m vg01/lvol01 /dev/sda:8-9 /dev/sdb:8-9
.SH SEE ALSO
+.nh
+.ad l
+.BR lvm (8),
+.BR lvm.conf (5),
+.BR lvmconfig (8),
+.BR lvmdevices (8),
-.BR lvm (8)
-.BR lvm.conf (5)
-.BR lvmconfig (8)
-.BR lvmdevices (8)
-
-.BR pvchange (8)
-.BR pvck (8)
-.BR pvcreate (8)
-.BR pvdisplay (8)
-.BR pvmove (8)
-.BR pvremove (8)
-.BR pvresize (8)
-.BR pvs (8)
-.BR pvscan (8)
+.BR pvchange (8),
+.BR pvck (8),
+.BR pvcreate (8),
+.BR pvdisplay (8),
+.BR pvmove (8),
+.BR pvremove (8),
+.BR pvresize (8),
+.BR pvs (8),
+.BR pvscan (8),
-.BR vgcfgbackup (8)
-.BR vgcfgrestore (8)
-.BR vgchange (8)
-.BR vgck (8)
-.BR vgcreate (8)
-.BR vgconvert (8)
-.BR vgdisplay (8)
-.BR vgexport (8)
-.BR vgextend (8)
-.BR vgimport (8)
-.BR vgimportclone (8)
-.BR vgimportdevices (8)
-.BR vgmerge (8)
-.BR vgmknodes (8)
-.BR vgreduce (8)
-.BR vgremove (8)
-.BR vgrename (8)
-.BR vgs (8)
-.BR vgscan (8)
-.BR vgsplit (8)
+.BR vgcfgbackup (8),
+.BR vgcfgrestore (8),
+.BR vgchange (8),
+.BR vgck (8),
+.BR vgcreate (8),
+.BR vgconvert (8),
+.BR vgdisplay (8),
+.BR vgexport (8),
+.BR vgextend (8),
+.BR vgimport (8),
+.BR vgimportclone (8),
+.BR vgimportdevices (8),
+.BR vgmerge (8),
+.BR vgmknodes (8),
+.BR vgreduce (8),
+.BR vgremove (8),
+.BR vgrename (8),
+.BR vgs (8),
+.BR vgscan (8),
+.BR vgsplit (8),
-.BR lvcreate (8)
-.BR lvchange (8)
-.BR lvconvert (8)
-.BR lvdisplay (8)
-.BR lvextend (8)
-.BR lvreduce (8)
-.BR lvremove (8)
-.BR lvrename (8)
-.BR lvresize (8)
-.BR lvs (8)
-.BR lvscan (8)
+.BR lvcreate (8),
+.BR lvchange (8),
+.BR lvconvert (8),
+.BR lvdisplay (8),
+.BR lvextend (8),
+.BR lvreduce (8),
+.BR lvremove (8),
+.BR lvrename (8),
+.BR lvresize (8),
+.BR lvs (8),
+.BR lvscan (8),
-.BR lvm-fullreport (8)
-.BR lvm-lvpoll (8)
-.BR lvm2-activation-generator (8)
-.BR blkdeactivate (8)
-.BR lvmdump (8)
+.BR lvm-fullreport (8),
+.BR lvm-lvpoll (8),
+.BR lvm2-activation-generator (8),
+.BR blkdeactivate (8),
+.BR lvmdump (8),
-.BR dmeventd (8)
-.BR lvmpolld (8)
-.BR lvmlockd (8)
-.BR lvmlockctl (8)
-.BR cmirrord (8)
-.BR lvmdbusd (8)
+.BR dmeventd (8),
+.BR lvmpolld (8),
+.BR lvmlockd (8),
+.BR lvmlockctl (8),
+.BR cmirrord (8),
+.BR lvmdbusd (8),
-.BR lvmsystemid (7)
-.BR lvmreport (7)
-.BR lvmraid (7)
-.BR lvmthin (7)
+.BR lvmsystemid (7),
+.BR lvmreport (7),
+.BR lvmraid (7),
+.BR lvmthin (7),
.BR lvmcache (7)