~ubuntu-branches/debian/sid/lvm2/sid

« back to all changes in this revision

Viewing changes to man/vgextend.8.in

  • Committer: Package Import Robot
  • Author(s): Bastian Blank
  • Date: 2013-03-03 12:33:47 UTC
  • mfrom: (1.1.15)
  • Revision ID: package-import@ubuntu.com-20130303123347-smfwei6dodkdth55
Tags: 2.02.98-1
New upstream version.

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
vgextend \- add physical volumes to a volume group
4
4
.SH SYNOPSIS
5
5
.B vgextend
6
 
[\-A|\-\-autobackup y|n] [\-d|\-\-debug] [\-h|\-?|\-\-help] 
7
 
[\-\-restoremissing]
8
 
[\-f|\-\-force]
9
 
[\-t|\-\-test]
10
 
[\-v|\-\-verbose]
11
 
[ \fIPHYSICAL DEVICE OPTIONS\fP ]
12
 
VolumeGroupName PhysicalDevicePath [PhysicalDevicePath...]
 
6
.RB [ \-A | \-\-autobackup
 
7
.RI { y | n }]
 
8
.RB [ \-d | \-\-debug ]
 
9
.RB [ \-h | \-? | \-\-help ]
 
10
.RB [ \-\-restoremissing ]
 
11
.RB [ \-f | \-\-force ]
 
12
.RB [ \-t | \-\-test ]
 
13
.RB [ \-v | \-\-verbose ]
 
14
.RB [ "PHYSICAL DEVICE OPTIONS" ]
 
15
.I VolumeGroupName PhysicalDevicePath
 
16
.RI [ PhysicalDevicePath ...]
13
17
.SH DESCRIPTION
14
 
vgextend allows you to add one or more initialized physical volumes ( see
15
 
.B pvcreate(8)
16
 
) to an existing volume group to extend it in size. Moreover, it allows you to
 
18
vgextend allows you to add one or more initialized physical volumes
 
19
(see \fBpvcreate\fP(8)) to an existing volume group to extend it in size. Moreover, it allows you to
17
20
re-add a physical volume that has gone missing previously, due to a transient
18
 
device failure, without re-initialising it. Use vgextend \-\-restoremissing to
19
 
that effect.
 
21
device failure, without re-initialising it. Use
 
22
\fBvgextend \-\-restoremissing\fP to that effect.
20
23
.sp
21
24
If \fIPhysicalDevicePath\fP was not previously configured for LVM with
22
 
\fBpvcreate (8)\fP, the device will be initialized with the same
23
 
default values used with \fBpvcreate\fP.  If non-default
24
 
\fPpvcreate\fP values are are desired, they may be given on the
25
 
commandline with the same options as \fPpvcreate\fP.  See
26
 
\fBPHYSICAL DEVICE OPTIONS\fP for available options.  Note
27
 
that the restore-related options such as --restorefile, --uuid,
28
 
and --physicalvolumesize are not available.  If a restore operation
29
 
is needed, use \fBpvcreate (8)\fP and \fBvgcfgrestore (8)\fP.
 
25
\fBpvcreate\fP(8), the device will be initialized with the same
 
26
default values used with \fBpvcreate\fP(8).  If non-default
 
27
\fPpvcreate\fP(8) values are desired, they may be given on the
 
28
commandline with the same options as \fPpvcreate\fP(8).  See
 
29
.B PHYSICAL DEVICE OPTIONS
 
30
for available options.  Note that the restore-related options such as
 
31
.BR \-\-restorefile ", " \-\-uuid " and " \-\-physicalvolumesize
 
32
are not available.  If a restore operation
 
33
is needed, use \fBpvcreate\fP(8) and \fBvgcfgrestore\fP(8).
30
34
.SH OPTIONS
31
 
See \fBlvm\fP for common options.
 
35
See \fBlvm\fP(8) for common options.
32
36
.SH PHYSICAL DEVICE OPTIONS
33
37
The following options are available for initializing physical devices in the
34
 
volume group.  These options are further described in the pvcreate man page.
 
38
volume group.  These options are further described in the
 
39
\fBpvcreate\fP(8) man page.
35
40
.TP
36
41
.BR \-f ", " \-\-force
37
42
.TP
38
43
.BR \-y ", " \-\-yes
39
44
.TP
40
 
.BR \-Z ", " \-\-zero " y|n"
41
 
.TP
42
 
.BR \-\-labelsector " sector"
43
 
.TP
44
 
.BR \-\-metadatasize " size"
45
 
.TP
46
 
.RB [ \-\-metadataignore y|n ]
47
 
.TP
48
 
.BR \-\-pvmetadatacopies " copies"
49
 
.TP
50
 
.BR \-\-dataalignment " alignment"
51
 
.TP
52
 
.BR \-\-dataalignmentoffset " alignment_offset"
 
45
.BR \-Z ", " \-\-zero " {" \fIy | \fIn }
 
46
.TP
 
47
.B \-\-labelsector \fIsector
 
48
.TP
 
49
.B \-\-metadatasize \fIsize
 
50
.TP
 
51
.BR \-\-metadataignore " {" \fIy | \fIn }
 
52
.TP
 
53
.B \-\-pvmetadatacopies \fIcopies
 
54
.TP
 
55
.B \-\-dataalignment \fIalignment
 
56
.TP
 
57
.B \-\-dataalignmentoffset \fIalignment_offset
53
58
.SH Examples
54
 
"vgextend vg00 /dev/sda4 /dev/sdn1" tries to extend the existing volume
55
 
group "vg00" by the new physical volumes (see
56
 
.B pvcreate(8)
57
 
) "/dev/sdn1" and /dev/sda4".
 
59
Extends the existing volume group "vg00" by the new physical volumes
 
60
(see \fBpvcreate\fP(8)) "/dev/sda4" and "/dev/sdn1".
 
61
.sp
 
62
.B vgextend vg00 /dev/sda4 /dev/sdn1
58
63
.SH SEE ALSO
59
64
.BR lvm (8),
60
65
.BR vgcreate (8),