contrib/lvm2/dist/man/vgextend.8.in

   1 .TH VGEXTEND 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
   2 .SH NAME
   3 vgextend \- add physical volumes to a volume group
   4 .SH SYNOPSIS
   5 .B vgextend
   6 [\-A|\-\-autobackup y|n] [\-d|\-\-debug] [\-h|\-?|\-\-help]
   7 [\-t|\-\-test]
   8 [\-v|\-\-verbose]
   9 [ \fIPHYSICAL DEVICE OPTIONS\fP ]
  10 VolumeGroupName PhysicalDevicePath [PhysicalDevicePath...]
  11 .SH DESCRIPTION
  12 vgextend allows you to add one or more initialized physical volumes ( see
  13 .B pvcreate(8)
  14 ) to an existing volume group to extend it in size.
  15 .sp
  16 If \fIPhysicalDevicePath\fP was not previously configured for LVM with
  17 \fBpvcreate (8)\fP, the device will be initialized with the same
  18 default values used with \fBpvcreate\fP.  If non-default
  19 \fPpvcreate\fP values are are desired, they may be given on the
  20 commandline with the same options as \fPpvcreate\fP.  See
  21 \fBPHYSICAL DEVICE OPTIONS\fP for available options.  Note
  22 that the restore-related options such as --restorefile, --uuid,
  23 and --physicalvolumesize are not available.  If a restore operation
  24 is needed, use \fBpvcreate (8)\fP and \fBvgcfgrestore (8)\fP.
  25 .SH OPTIONS
  26 See \fBlvm\fP for common options.
  27 .SH PHYSICAL DEVICE OPTIONS
  28 The following options are available for initializing physical devices in the
  29 volume group.  These options are further described in the pvcreate man page.
  30 .TP
  31 .BR \-f ", " \-\-force
  32 .TP
  33 .BR \-y ", " \-\-yes
  34 .TP
  35 .BR \-Z ", " \-\-zero " y|n"
  36 .TP
  37 .BR \-\-labelsector " sector"
  38 .TP
  39 .BR \-\-metadatasize " size"
  40 .TP
  41 .BR \-\-pvmetadatacopies " copies"
  42 .TP
  43 .BR \-\-dataalignment " alignment"
  44 .TP
  45 .BR \-\-dataalignmentoffset " alignment_offset"
  46 .SH Examples
  47 "vgextend vg00 /dev/sda4 /dev/sdn1" tries to extend the existing volume
  48 group "vg00" by the new physical volumes (see
  49 .B pvcreate(8)
  50 ) "/dev/sdn1" and /dev/sda4".
  51 .SH SEE ALSO
  52 .BR lvm (8),
  53 .BR vgcreate (8),
  54 .BR vgreduce (8),
  55 .BR pvcreate (8)