summaryrefslogtreecommitdiffstats
path: root/man/vgimportclone.8.in
diff options
context:
space:
mode:
Diffstat (limited to 'man/vgimportclone.8.in')
-rw-r--r--man/vgimportclone.8.in59
1 files changed, 24 insertions, 35 deletions
diff --git a/man/vgimportclone.8.in b/man/vgimportclone.8.in
index 7b84df4d..52ff079a 100644
--- a/man/vgimportclone.8.in
+++ b/man/vgimportclone.8.in
@@ -3,55 +3,44 @@
vgimportclone \- import and rename duplicated volume group (e.g. a hardware snapshot)
.SH SYNOPSIS
.B vgimportclone
-[\-n|\-\-basevgname VolumeGroupName]
-[\-i|\-\-import]
-PhysicalVolume [PhysicalVolume...]
+.RB [ \-n | \-\-basevgname
+.IR VolumeGroupName ]
+.RB [ \-i | \-\-import ]
+.I PhysicalVolume
+.RI [ PhysicalVolume ...]
.SH DESCRIPTION
-.B vgimportclone
-is used to import a duplicated VG (e.g. hardware snapshot). Duplicate VG(s)
-and PV(s) are not able to be used until they are made to coexist with
-the origin VG(s) and PV(s).
-.B vgimportclone
-renames the VG associated with the specified PV(s) and changes the
-associated VG and PV UUIDs.
+vgimportclone is used to import a duplicated VG (e.g. hardware snapshot).
+Duplicate VG(s) and PV(s) are not able to be used until they are made
+to coexist with the origin VG(s) and PV(s).
+vgimportclone renames the VG associated with the specified PV(s) and
+changes the associated VG and PV UUIDs.
.SH OPTIONS
-See \fBlvm\fP for common options.
+See \fBlvm\fP(8) for common options.
.TP
-.I \-n|\-\-basevgname VolumeGroupName
+.BR \-n ", " \-\-basevgname " " \fIVolumeGroupName
By default the snapshot VG will be renamed to the original name plus a
numeric suffix to avoid duplicate naming (e.g. 'test_vg' would be renamed
to 'test_vg1'). This option will override the base VG name that is
used for all VG renames. If a VG already exists with the specified name
a numeric suffix will be added (like the previous example) to make it unique.
.TP
-.I \-i|\-\-import
+.BR \-i ", " \-\-import
Import exported Volume Groups. Otherwise VGs that have been exported
will not be changed (nor will their associated PVs).
.SH ENVIRONMENT VARIABLES
.TP
-\fBLVM_BINARY\fP
-The LVM2 binary to use.
-Defaults to "lvm".
-.SH EXAMPLES
-The origin VG
-.B vg00
-has origin PVs
-.BR /dev/sda " and " /dev/sdb
-and the respective snapshot PVs are
-.BR /dev/sdc " and " /dev/sdd "."
-To rename the VG
-associated with
-.BR /dev/sdc " and " /dev/sdd
-from
-.B vg00
-to
-.B vg00_snap
+.B LVM_BINARY
+The LVM2 binary to use. Defaults to "lvm".
+.SH Examples
+The origin VG "vg00" has origin PVs "/dev/sda" and "/dev/sdb"
+and the respective snapshot PVs are "/dev/sdc" and "/dev/sdd".
+To rename the VG associated with "/dev/sdc" and "/dev/sdd"
+from "vg00" to "vg00_snap"
(and to change associated VG and PV UUIDs) do:
-.nf
-
-\ vgimportclone --basevgname vg00_snap /dev/sdc /dev/sdd
+.sp
+.B vgimportclone --basevgname vg00_snap /dev/sdc /dev/sdd
-.fi
.SH SEE ALSO
-.BR lvm (8)
+.BR lvm (8),
+.BR vgrename (8)