From mboxrd@z Thu Jan 1 00:00:00 1970 From: Elena Ufimtseva Subject: [PATCH v5 3/8] vnuma xl.cfg.pod and idl config options Date: Tue, 3 Jun 2014 00:53:15 -0400 Message-ID: <1401771200-11448-5-git-send-email-ufimtseva@gmail.com> References: <1401771200-11448-1-git-send-email-ufimtseva@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Return-path: In-Reply-To: <1401771200-11448-1-git-send-email-ufimtseva@gmail.com> List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Sender: xen-devel-bounces@lists.xen.org Errors-To: xen-devel-bounces@lists.xen.org To: xen-devel@lists.xen.org Cc: keir@xen.org, Ian.Campbell@citrix.com, stefano.stabellini@eu.citrix.com, george.dunlap@eu.citrix.com, msw@linux.com, dario.faggioli@citrix.com, lccycc123@gmail.com, ian.jackson@eu.citrix.com, JBeulich@suse.com, Elena Ufimtseva List-Id: xen-devel@lists.xenproject.org Signed-off-by: Elena Ufimtseva --- docs/man/xl.cfg.pod.5 | 64 ++++++++++++++++++++++++++++++++++++++++++- tools/libxl/libxl_types.idl | 6 +++- 2 files changed, 68 insertions(+), 2 deletions(-) diff --git a/docs/man/xl.cfg.pod.5 b/docs/man/xl.cfg.pod.5 index a94d037..cf98c2b 100644 --- a/docs/man/xl.cfg.pod.5 +++ b/docs/man/xl.cfg.pod.5 @@ -242,6 +242,66 @@ if the values of B and B differ. A "pre-ballooned" HVM guest needs a balloon driver, without a balloon driver it will crash. +=item B + +Number of vNUMA nodes the guest will be initialized with on boot. + +=item B + +The vnode memory sizes defined in MBytes. If the sum of all vnode memories +does not match the domain memory or not all the nodes defined here, will fail. +If not specified, memory will be equally split between vnodes. Currently +minimum vnode size is 64MB. + +Example: vnuma_mem=[1024, 1024, 2048, 2048] + +=item B + +Defines the distance table for vNUMA nodes. Distance for NUMA machines usually + represented by two dimensional array and all distance may be spcified in one +line here, by rows. Distance can be specified as two numbers [d1, d2], +where d1 is same node distance, d2 is a value for all other distances. +If not specified, the defaul distance will be used, e.g. [10, 20]. + +Examples: +vnodes = 3 +vdistance=[10, 20] +will expand to this distance table (this is default setting as well): +[10, 20, 20] +[20, 10, 20] +[20, 20, 10] + +=item B + +Defines vcpu to vnode mapping as a string of integers, representing node +numbers. If not defined, the vcpus are interleaved over the virtual nodes. +Current limitation: vNUMA nodes have to have at least one vcpu, otherwise +default vcpu_to_vnode will be used. + +Example: +to map 4 vcpus to 2 nodes - 0,1 vcpu -> vnode1, 2,3 vcpu -> vnode2: +vnuma_vcpumap = [0, 0, 1, 1] + +=item B + +vnode to pnode mapping. Can be configured if manual vnode allocation +required. Will be only taken into effect on real NUMA machines and if +memory or other constraints do not prevent it. If the mapping is ok, +automatic NUMA placement will be disabled. If the mapping incorrect +and vnuma_autoplacement is true, automatical numa placement will be used, +otherwise fails to create domain. + +Example: +assume two node NUMA node machine: +vnuma_vndoemap=[1, 0] +first vnode will be placed on node 1, second on node0. + +=item B + +If enabled, automatically will find the best placement physical node candidate for +each vnode if vnuma_vnodemap is incorrect or memory requirements prevent +using it. Set to '0' by default. + =back =head3 Event Actions @@ -620,6 +680,7 @@ must be given in hexadecimal. It is recommended to use this option only for trusted VMs under administrator control. + =item B Allow a guest to access specific physical IRQs. @@ -701,7 +762,6 @@ it is safe to allow this to be enabled but you may wish to disable it anyway. =item B - Selects whether to run this PV guest in an HVM container. Default is 0. =back @@ -944,6 +1004,7 @@ preceded by a 32b integer indicating the size of the next structure. =item B + Specifies how the TSC (Time Stamp Counter) should be provided to the guest (X86 only). Specifying this option as a number is deprecated. Options are: @@ -989,6 +1050,7 @@ i.e. set to UTC. Set the real time clock offset in seconds. False (0) by default. + =item B Specifies that periodic Virtual Platform Timers should be aligned to diff --git a/tools/libxl/libxl_types.idl b/tools/libxl/libxl_types.idl index 52f1aa9..f9fb21e 100644 --- a/tools/libxl/libxl_types.idl +++ b/tools/libxl/libxl_types.idl @@ -313,7 +313,11 @@ libxl_domain_build_info = Struct("domain_build_info",[ ("disable_migrate", libxl_defbool), ("cpuid", libxl_cpuid_policy_list), ("blkdev_start", string), - + ("numa_memszs", Array(uint64, "nr_nodes")), + ("cpu_to_node", Array(uint32, "nr_nodemap")), + ("distance", Array(uint32, "nr_dist")), + ("vnode_to_pnode", Array(uint32, "nr_node_to_pnode")), + ("vnuma_autoplacement", libxl_defbool), ("device_model_version", libxl_device_model_version), ("device_model_stubdomain", libxl_defbool), # if you set device_model you must set device_model_version too -- 1.7.10.4