mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-21 13:34:40 +03:00
0ddb66efba
Going forward, we would like to allow users to specify the total number of metadatacopies in a VG rather than on a per-PV basis. In order to facilitate that, introduce --pvmetadatacopes to replace --metadatacopies everywhere. We still allow --metadatacopies for pv commands, but require --pvmetadatacopies for vg commands. Eventually we will introduce --vgmetadatacopies. Once we do that, we should either deprecate --metadatacopies or make it a synonym based on the command (pvmetadatacopies for pv commands, and vgmetadatacopies for vg commands). The latter option would likely just require a simple 'strncpy' check against cmd->command->name to qualify the merge_synonym call. Update nightly tests to cover the pvmetadatacopies synonym. Note that this patch is the result of an eariler review comment for the implicit pvcreate patches. Should apply cleanly on top of the implicit pvcreate patches (I applied after patch 10/10 in that series). NOTE: This patch will require --pvmetadatacopies for vgconvert as --metadatacopies is no longer accepted.
60 lines
2.0 KiB
Groff
60 lines
2.0 KiB
Groff
.TH VGEXTEND 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
|
|
.SH NAME
|
|
vgextend \- add physical volumes to a volume group
|
|
.SH SYNOPSIS
|
|
.B vgextend
|
|
[\-A|\-\-autobackup y|n] [\-d|\-\-debug] [\-h|\-?|\-\-help]
|
|
[\-t|\-\-test]
|
|
[\-v|\-\-verbose]
|
|
.RB [ PHYSICAL DEVICE OPTIONS ]
|
|
VolumeGroupName PhysicalDevicePath [PhysicalDevicePath...]
|
|
.SH DESCRIPTION
|
|
vgextend allows you to add one or more initialized physical volumes ( see
|
|
.B pvcreate(8)
|
|
) to an existing volume group to extend it in size.
|
|
.sp
|
|
If \fIPhysicalDevicePath\fP was not previously configured for LVM with
|
|
\fBpvcreate (8)\fP, the device will be initialized with the same
|
|
default values used with \fBpvcreate\fP. If non-default
|
|
\fPpvcreate\fP values are are desired, they may be given on the
|
|
commandline with the same options as \fPpvcreate\fP. See
|
|
\fBPHYSICAL DEVICE OPTIONS\fP for available options. Note
|
|
that the restore-related options such as --restorefile, --uuid,
|
|
and --physicalvolumesize are not available. If a restore operation
|
|
is needed, use \fBpvcreate (8)\fP and \fBvgcfgrestore (8)\fP.
|
|
\fBpvcreate (8)\fP, the device will be initialized with the same
|
|
default values used with \fBpvcreate\fP. If non-default
|
|
\fPpvcreate\fP values are are desired, \fBpvcreate\fP should be explicitly
|
|
called prior to calling \fBvgcreate\fP.
|
|
.SH OPTIONS
|
|
See \fBlvm\fP for common options.
|
|
.SH PHYSICAL DEVICE OPTIONS
|
|
The following options are available for initializing physical devices in the
|
|
volume group. These options are further described in the pvcreate man page.
|
|
.TP
|
|
.BR \-f ", " \-\-force
|
|
.TP
|
|
.BR \-y ", " \-\-yes
|
|
.TP
|
|
.BR \-Z ", " \-\-zero " y|n"
|
|
.TP
|
|
.BR \-\-labelsector " sector"
|
|
.TP
|
|
.BR \-\-metadatasize " size"
|
|
.TP
|
|
.BR \-\-pvmetadatacopies " copies"
|
|
.TP
|
|
.BR \-\-dataalignment " alignment"
|
|
.TP
|
|
.BR \-\-dataalignmentoffset " alignment_offset"
|
|
.SH Examples
|
|
"vgextend vg00 /dev/sda4 /dev/sdn1" tries to extend the existing volume
|
|
group "vg00" by the new physical volumes (see
|
|
.B pvcreate(8)
|
|
) "/dev/sdn1" and /dev/sda4".
|
|
.SH SEE ALSO
|
|
.BR lvm (8),
|
|
.BR vgcreate (8),
|
|
.BR vgreduce (8),
|
|
.BR pvcreate (8)
|