From fa28124b3d35b9e3e09d5d6cf0e08dddae055f55 Mon Sep 17 00:00:00 2001 From: immarvin Date: Tue, 22 Dec 2015 04:36:25 -0500 Subject: [PATCH] update chvm manpage in doc --- .../admin-guides/references/man1/chvm.1.rst | 82 +++++++++++-------- 1 file changed, 47 insertions(+), 35 deletions(-) diff --git a/docs/source/guides/admin-guides/references/man1/chvm.1.rst b/docs/source/guides/admin-guides/references/man1/chvm.1.rst index 43de354af..335a396d3 100644 --- a/docs/source/guides/admin-guides/references/man1/chvm.1.rst +++ b/docs/source/guides/admin-guides/references/man1/chvm.1.rst @@ -49,12 +49,19 @@ PPC (using Direct FSP Management) specific: [\ **del_physlots=drc_index1,drc_index2...**\ ] [\ **del_vadapter=slotid**\ ] + +KVM specific: +============= + + \ **chvm**\ \ *noderange*\ [\ **--cpupin**\ \ *hostcpuset*\ ] \ **chvm**\ \ *noderange*\ [\ **--membind**\ \ *numanodeset*\ ] \ **chvm**\ \ *noderange*\ [\ **--devpassthru**\ \ *pcidevice*\ ...] +\ **chvm**\ \ *noderange*\ [\ **--devdetach**\ \ *pcidevice*\ ...] + VMware/KVM specific: ==================== @@ -160,13 +167,6 @@ For normal power machine: chvm could be used to modify the resources assigned to partitions. The admin shall specify the attributes with options \ *vmcpus*\ , \ *vmmemory*\ , \ *add_physlots*\ , \ *vmothersetting*\ , \ *add_vmnics*\ and/or \ *add_vmstorage*\ . If nothing specified, nothing will be returned. -VMware/KVM specific: -==================== - - -The chvm command modifes the vm specified in noderange. Calling with deregister or purge options at the same time as the resize option is not recommended. - - zVM specific: ============= @@ -303,34 +303,6 @@ PPC (using Direct FSP Management) specific: -\ **--cpupin hostcpuset**\ - - To pin guest domain virtual CPUs to physical host CPUs specified with \ *hostcpuset*\ . - \ *hostcpuset*\ 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. - - 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". - - - -\ **--membind numanodeset**\ - - It is possible to restrict a guest to allocate memory from the specified set of NUMA nodes \ *numanodeset*\ . - 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. - - - -\ **--devpassthru pcidevice1,pcidevice2...**\ - - The PCI passthrough gives a guest VM direct access to I/O devices \ *pcidevice1,pcidevice2...*\ . - 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 \ **virsh nodedev-list**\ on the host. - - - VMware/KVM specific: ==================== @@ -374,6 +346,46 @@ VMware/KVM specific: +KVM specific: +============= + + + +\ **--cpupin hostcpuset**\ + + To pin guest domain virtual CPUs to physical host CPUs specified with \ *hostcpuset*\ . + \ *hostcpuset*\ 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. + + 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". + + + +\ **--membind numanodeset**\ + + It is possible to restrict a guest to allocate memory from the specified set of NUMA nodes \ *numanodeset*\ . + 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. + + + +\ **--devpassthru pcidevice1,pcidevice2...**\ + + The PCI passthrough gives a guest VM direct access to I/O devices \ *pcidevice1,pcidevice2...*\ . + 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 \ **virsh nodedev-list**\ on the host. + + + +\ **--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 \ **virsh nodedev-list**\ on the host. + + + + zVM specific: =============