shaba/lvm2
1
0
Fork 0
mirror of git://sourceware.org/git/lvm2.git synced 2025-01-03 05:18:29 +03:00
Code Releases Activity

Update vgcreate and vgextend man pages to clarify implicit pvcreate.

Browse Source 
vgcreate and vgextend now implicitly call pvcreate on devices not
currently initialized for LVM use.  Previously these commands would
fail with an error, so clarify the new behavior in the man page.
This commit is contained in:
Dave Wysochanski 2009-10-05 20:04:21 +00:00
parent 2e201936e4
commit 2ce3412b46
2 changed files with 67 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
man/vgcreate.8.in
View File

@ -21,16 +21,24 @@ vgcreate \- create a volume group
.RB [ \-t | \-\-test ]
.RB [ \-v | \-\-verbose ]
.RB [ \-\-version ]
.I VolumeGroupName PhysicalVolumePath
.RI [ PhysicalVolumePath ...]
.RB [ PHYSICAL DEVICE OPTIONS ]
.I VolumeGroupName PhysicalDevicePath
.RI [ PhysicalDevicePath ...]
.SH DESCRIPTION
.B vgcreate
creates a new volume group called
.I VolumeGroupName
using the block special device
.IR PhysicalVolumePath
previously configured for LVM with
.BR pvcreate (8).
using the block special device \fIPhysicalDevicePath\fP.
.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.
.SH OPTIONS
See \fBlvm\fP for common options.
.TP
@ -86,6 +94,25 @@ but having a large number of extents will slow down the tools but have no
impact on I/O performance to the logical volume. The smallest PE is 1KB.
The 2.4 kernel has a limitation of 2TB per block device.
.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 \-\-metadatacopies " copies"
.TP
.BR \-\-dataalignment " alignment"
.TP
.BR \-\-dataalignmentoffset " alignment_offset"
.SH EXAMPLES
To create a volume group named
.B test_vg

34
man/vgextend.8.in
View File

@ -6,13 +6,47 @@ vgextend \- add physical volumes to a volume group
[\-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 \-\-metadatacopies " 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