From 3361e662f4b05096ca6cae9f4d96bbeec8ec4862 Mon Sep 17 00:00:00 2001 From: David Teigland Date: Fri, 20 Feb 2015 14:58:01 -0600 Subject: [PATCH] man: systemid option for vgcreate and vgchange --- man/vgchange.8.in | 8 ++++++++ man/vgcreate.8.in | 13 ++++++++++++- 2 files changed, 20 insertions(+), 1 deletion(-) diff --git a/man/vgchange.8.in b/man/vgchange.8.in index 5014300e3..e6e850ac8 100644 --- a/man/vgchange.8.in +++ b/man/vgchange.8.in @@ -47,6 +47,8 @@ vgchange \(em change attributes of a volume group .IR PhysicalExtentSize [ bBsSkKmMgGtTpPeE ]] .RB [ \-S | \-\-select .IR Selection ] +.RB [ \-\-systemid +.IR SystemID ] .RB [ \-\-refresh ] .RB [ \-t | \-\-test ] .RB [ \-v | \-\-verbose ] @@ -243,6 +245,12 @@ impact on I/O performance to the logical volume. The smallest PE is 1KiB. The 2.4 kernel has a limitation of 2TiB per block device. .TP +.BR \-\-systemid " " \fISystemID +Changes the system ID of the VG. Using this option requires caution +because the VG may become foreign to the host running the command, +leaving the host unable to access it. See +.BR lvmsystemid (7). +.TP .BR \-\-refresh If any logical volume in the volume group is active, reload its metadata. This is not necessary in normal operation, but may be useful diff --git a/man/vgcreate.8.in b/man/vgcreate.8.in index d850659fe..c55dbfef7 100644 --- a/man/vgcreate.8.in +++ b/man/vgcreate.8.in @@ -27,6 +27,8 @@ vgcreate \(em create a volume group .IR NumberOfCopies | unmanaged | all ] .RB [ \-s | \-\-physicalextentsize .IR PhysicalExtentSize [ bBsSkKmMgGtTpPeE ]] +.RB [ \-\-systemid +.IR SystemID ] .RB [ \-t | \-\-test ] .RB [ \-v | \-\-verbose ] .RB [ \-\-version ] @@ -110,7 +112,6 @@ power of 2 of at least 1 sector (where the sector size is the largest sector size of the PVs currently used in the VG) or, if not a power of 2, at least 128KiB. For the older LVM1 format, it must be a power of 2 of at least 8KiB. The default is 4 MiB. - Once this value has been set, it is difficult to change it without recreating the volume group which would involve backing up and restoring data on any logical volumes. However, if no extents need moving for the new @@ -126,6 +127,16 @@ impact on I/O performance to the logical volume. The smallest PE is 1KiB The 2.4 kernel has a limitation of 2TiB per block device. +.TP +.BR \-\-systemid " " \fISystemID +Specifies the system ID that will be given to the new VG, overriding the +system ID of the host running the command. A VG is normally created +without this option, in which case the new VG is given the system ID of +the host creating it. Using this option requires caution because the +system ID of the new VG may not match the system ID of the host running +the command, leaving the VG inaccessible to the host. See +.BR lvmsystemid (7). + .SH PHYSICAL DEVICE OPTIONS The following options are available for initializing physical devices in the volume group. These options are further described in the \fBpvcreate\fP(8)