From 56ffbfdb4d8b24dd73040fee79b23ad10ff6fe7e Mon Sep 17 00:00:00 2001 From: GONG Jie Date: Sun, 31 Dec 2017 23:59:59 +0000 Subject: [PATCH] Remove trailing spaces in file xCAT-client/pods/man1/chvm.1.pod --- xCAT-client/pods/man1/chvm.1.pod | 82 ++++++++++++++++---------------- 1 file changed, 41 insertions(+), 41 deletions(-) diff --git a/xCAT-client/pods/man1/chvm.1.pod b/xCAT-client/pods/man1/chvm.1.pod index f1ac27855..52331a325 100644 --- a/xCAT-client/pods/man1/chvm.1.pod +++ b/xCAT-client/pods/man1/chvm.1.pod @@ -31,11 +31,11 @@ B I [B<--cpupin> I] B I [B<--membind> I] -B I [B<--devpassthru> I...] +B I [B<--devpassthru> I...] + +B I [B<--devdetach> I...] -B I [B<--devdetach> I...] - =head2 VMware/KVM specific: B I [B<-a> I] [B<-d> I] [B<-p> I] [B<--resize> I=I] [B<--cpus> I] [B<--mem> I] @@ -106,7 +106,7 @@ B I [B<--undedicatedevice> I] =head2 PPC (with HMC) specific: -The chvm command modifies the partition profile for the partitions specified in noderange. A partitions current profile can be read using lsvm, modified, and piped into the chvm command, or changed with the -p flag. +The chvm command modifies the partition profile for the partitions specified in noderange. A partitions current profile can be read using lsvm, modified, and piped into the chvm command, or changed with the -p flag. This command also supports to change specific partition attributes by specifying one or more "attribute equals value" pairs in command line directly, without whole partition profile. @@ -114,15 +114,15 @@ This command also supports to change specific partition attributes by specifying For Power 755(use option I<--p775> to specify): -chvm could be used to change the octant configuration values for generating LPARs. chvm is designed to set the Octant configure value to split the CPU and memory for partitions, and set Octant Memory interleaving value. The chvm will only set the pending attributes value. After chvm, the CEC needs to be rebooted manually for the pending values to be enabled. Before reboot the cec, the administrator can use chvm to change the partition plan. If the partition needs I/O slots, the administrator should use chvm to assign the I/O slots. +chvm could be used to change the octant configuration values for generating LPARs. chvm is designed to set the Octant configure value to split the CPU and memory for partitions, and set Octant Memory interleaving value. The chvm will only set the pending attributes value. After chvm, the CEC needs to be rebooted manually for the pending values to be enabled. Before reboot the cec, the administrator can use chvm to change the partition plan. If the partition needs I/O slots, the administrator should use chvm to assign the I/O slots. -chvm is also designed to assign the I/O slots to the new LPAR. Both the current IO owning lpar and the new IO owning lpar must be powered off before an IO assignment. Otherwise, if the I/O slot is belonged to an Lpar and the LPAR is power on, the command will return an error when trying to assign that slot to a different lpar. +chvm is also designed to assign the I/O slots to the new LPAR. Both the current IO owning lpar and the new IO owning lpar must be powered off before an IO assignment. Otherwise, if the I/O slot is belonged to an Lpar and the LPAR is power on, the command will return an error when trying to assign that slot to a different lpar. The administrator should use lsvm to get the profile content, and then edit the content, and add the node name with ":" manually before the I/O which will be assigned to the node. And then the profile can be piped into the chvm command, or changed with the -p flag. For normal power machine: -chvm could be used to modify the resources assigned to partitions. The admin shall specify the attributes with options I, I, I, I, I and/or I. If nothing specified, nothing will be returned. +chvm could be used to modify the resources assigned to partitions. The admin shall specify the attributes with options I, I, I, I, I and/or I. If nothing specified, nothing will be returned. =head2 zVM specific: @@ -175,13 +175,13 @@ Specify the operation is for Power 775 machines. Starting numeric id of the newly created partitions. For Power 775 using Direct FSP Management, the id value only could be B<1>, B<5>, B<9>, B<13>, B<17>, B<21>, B<25> and B<29>. Shall work with option B<--p775>. -=item B<-m> +=item B<-m> memory interleaving. The setting value only could be B<1> or B<2>. B<2> means B mode (also 2MC mode), the memory cannot be shared across the processors in an octant. B<1> means B mode (also 8MC mode) , the memory can be shared. The default value is B<1>. Shall work with option B<--p775>. -=item B<-r> +=item B<-r> -partition rule. Shall work with option B<--p775>. +partition rule. Shall work with option B<--p775>. If all the octants configuration value are same in one CEC, it will be " B<-r> B<0-7>:I" . @@ -201,7 +201,7 @@ Name of I/O slots assignment profile. Shall work with option B<--p775>. =item B={B<*>|B} -Set LPAR name for the specified lpars. If '*' specified, it means to get names from xCAT database and then set them for the specified lpars. If a string is specified, it only supports single node and the string will be set for the specified lpar. The user can use lsvm to check the lparnames for lpars. +Set LPAR name for the specified lpars. If '*' specified, it means to get names from xCAT database and then set them for the specified lpars. If a string is specified, it only supports single node and the string will be set for the specified lpar. The user can use lsvm to check the lparnames for lpars. =item B B B B @@ -209,7 +209,7 @@ To specify the parameters that will be modified. =item B B [B<--vios>] -To create new virtual adapter for the specified node. +To create new virtual adapter for the specified node. =item B @@ -262,26 +262,26 @@ Change the size of the Hard disk. The disk in I format can not be set to To pin guest domain virtual CPUs to physical host CPUs specified with I. I is a list of physical CPU numbers. Its syntax is a comma separated list and a special markup using '-' and '^' (ex. '0-4', '0-3,^2') can also be allowed. The '-' denotes the range and -the '^' denotes exclusive. +the '^' denotes exclusive. Note: The expression is sequentially evaluated, so "0-15,^8" is identical to "9-14,0-7,15" but not identical to "^8,0-15". =item B<--membind numanodeset> -It is possible to restrict a guest to allocate memory from the specified set of NUMA nodes I. +It is possible to restrict a guest to allocate memory from the specified set of NUMA nodes I. If the guest vCPUs are also pinned to a set of cores located on that same set of NUMA nodes, memory access is local and improves memory access performance. =item B<--devpassthru pcidevice1,pcidevice2...> -The PCI passthrough gives a guest VM direct access to I/O devices I. +The PCI passthrough gives a guest VM direct access to I/O devices I. The PCI devices are assigned to a virtual machine, and the virtual machine can use this I/O exclusively. -The devices list are a list of comma separated PCI device names delimited with comma, the PCI device names can be obtained by running B on the host. +The devices list are a list of comma separated PCI device names delimited with comma, the PCI device names can be obtained by running B on the host. =item B<--devdetach pcidevice1,pcidevice2...> -To detaching the PCI devices which are attached to VM guest via PCI passthrough from the VM guest. The devices list are a list of comma separated PCI device names delimited with comma, the PCI device names can be obtained by running B on the host. +To detaching the PCI devices which are attached to VM guest via PCI passthrough from the VM guest. The devices list are a list of comma separated PCI device names delimited with comma, the PCI device names can be obtained by running B on the host. =back @@ -328,12 +328,12 @@ Adds a v-disk to a virtual machine's directory entry. =item B<--addzfcp> I I I I I I I -Add a zFCP device to a device pool defined in xCAT. The device must have been -carved up in the storage controller and configured with a WWPN/LUN before it can -be added to the xCAT storage pool. z/VM does not have the ability to communicate -directly with the storage controller to carve up disks dynamically. xCAT will -find the a zFCP device in the specified pool that meets the size required, if -the WWPN and LUN are not given. The device address can be automatically assigned +Add a zFCP device to a device pool defined in xCAT. The device must have been +carved up in the storage controller and configured with a WWPN/LUN before it can +be added to the xCAT storage pool. z/VM does not have the ability to communicate +directly with the storage controller to carve up disks dynamically. xCAT will +find the a zFCP device in the specified pool that meets the size required, if +the WWPN and LUN are not given. The device address can be automatically assigned by specifying 'auto'. The WWPN/LUN can be set as the LOADDEV in the directory entry if (1) is specified as the 'loaddev'. @@ -451,7 +451,7 @@ Output is similar to: =head2 PPC (using Direct FSP Management) specific: -1. For Power 775, to create a new partition lpar1 on the first octant of the cec cec01, lpar1 will use all the cpu and memory of the octant 0, enter: +1. For Power 775, to create a new partition lpar1 on the first octant of the cec cec01, lpar1 will use all the cpu and memory of the octant 0, enter: mkdef -t node -o lpar1 mgt=fsp groups=all parent=cec01 nodetype=lpar hcp=cec01 @@ -492,7 +492,7 @@ then: chvm lpar1-lpar9 --p775 -i 1 -m 1 -r 0:5,1-7:1 -Output is similar to: +Output is similar to: lpar1: Success lpar2: Success @@ -526,7 +526,7 @@ then run the command: Output is similar to: lpar1: Success - + 7. For Normal Power machine, to modify the resource assigned to a partition: Before modify, the resource assigned to node 'lpar1' can be shown with: @@ -553,8 +553,8 @@ To modify the resource assignment: chvm lpar1 vmcpus=1/2/16 vmmemory=1G/8G/32G add_physlots=0x21010202 The output is similar to: - - lpar1: Success + + lpar1: Success The resource information after modification is similar to: @@ -572,7 +572,7 @@ The resource information after modification is similar to: lpar1: 1/2/2 lpar1: 128. -Note: The physical I/O resources specified with I will be appended to the specified partition. The physical I/O resources which are not specified but belonged to the partition will not be removed. For more information about I, refer to L. +Note: The physical I/O resources specified with I will be appended to the specified partition. The physical I/O resources which are not specified but belonged to the partition will not be removed. For more information about I, refer to L. =head2 VMware/KVM specific: @@ -587,31 +587,31 @@ Output is similar to: 1. To adds a 3390 (ECKD) disk to a virtual machine's directory entry: chvm gpok3 --add3390 POOL1 0101 2G MR - + Output is similar to: - + gpok3: Adding disk 0101 to LNX3... Done - + 2. To add a network adapter to a virtual machine's directory entry: chvm gpok3 --addnic 0600 QDIO 3 - + Output is similar to: - + gpok3: Adding NIC 0900 to LNX3... Done 3. To connects a given network adapter to a GuestLAN: chvm gpok3 --connectnic2guestlan 0600 GLAN1 LN1OWNR - + Output is similar to: - + gpok3: Connecting NIC 0600 to GuestLan GLAN1 on LN1OWNR... Done - + 4. To connects a given network adapter to a vSwitch: - + chvm gpok3 --connectnic2vswitch 0600 VSW1 - + Output is similar to: gpok3: Connecting NIC 0600 to vSwitch VSW1 on LNX3... Done @@ -619,7 +619,7 @@ Output is similar to: 5. To removes a minidisk from a virtual machine's directory entry: chvm gpok3 --removedisk 0101 - + Output is similar to: gpok3: Removing disk 0101 on LNX3... Done @@ -627,7 +627,7 @@ Output is similar to: 6. To Removes a network adapter from a virtual machine's directory entry: chvm gpok3 --removenic 0700 - + Output is similar to: gpok3: Removing NIC 0700 on LNX3... Done