[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PATCH 2/2] qemu-options: Rewrite -numa documentation
From: |
Eduardo Habkost |
Subject: |
[Qemu-devel] [PATCH 2/2] qemu-options: Rewrite -numa documentation |
Date: |
Mon, 23 Jan 2017 16:06:32 -0200 |
Rewrite the -numa documentation to clarify what exactly it does.
Signed-off-by: Eduardo Habkost <address@hidden>
---
qemu-options.hx | 38 ++++++++++++++++++++++++++++----------
1 file changed, 28 insertions(+), 10 deletions(-)
diff --git a/qemu-options.hx b/qemu-options.hx
index 780528d6ad..a2c5d6668d 100644
--- a/qemu-options.hx
+++ b/qemu-options.hx
@@ -125,16 +125,34 @@ STEXI
@item -numa node[,address@hidden,address@hidden@var{lastcpu}]][,address@hidden
@itemx -numa node[,address@hidden,address@hidden@var{lastcpu}]][,address@hidden
@findex -numa
-Simulate a multi node NUMA system. If @samp{mem}, @samp{memdev}
-and @samp{cpus} are omitted, resources are split equally. Also, note
-that the address@hidden option doesn't allocate any of the specified
-resources. That is, it just assigns existing resources to NUMA nodes. This
-means that one still has to use the @option{-m}, @option{-smp} options
-to allocate RAM and VCPUs respectively, and possibly @option{-object}
-to specify the memory backend for the @samp{memdev} suboption.
-
address@hidden and @samp{memdev} are mutually exclusive. Furthermore, if one
-node uses @samp{memdev}, all of them have to use it.
+Define a NUMA node and assign RAM and VCPUs to it.
+
address@hidden and @var{lastcpu} are CPU indexes. Each
address@hidden option represent a contiguous range of CPU indexes
+(or a single VCPU if @var{lastcpu} is omitted). A non-contiguous
+set of VCPUs can be represented by providing multiple @samp{cpus}
+options. If @samp{cpus} is omitted on all nodes, VCPUs are automatically
+split between them.
+
+For example, the following option assigns VCPUs 0, 1, 2 and 5 to
+a NUMA node:
address@hidden
+-numa node,cpus=0-2,cpus=5
address@hidden example
+
address@hidden assigns a given RAM amount to a node. @samp{memdev}
+assigns RAM from a given memory backend device to a node. If
address@hidden and @samp{memdev} are omitted in all nodes, RAM is
+split equally between them.
+
address@hidden and @samp{memdev} are mutually exclusive. Furthermore,
+if one node uses @samp{memdev}, all of them have to use it.
+
+Note that the address@hidden option doesn't allocate any of the
+specified resources, it just assigns existing resources to NUMA
+nodes. This means that one still has to use the @option{-m},
address@hidden options to allocate RAM and VCPUs respectively.
+
ETEXI
DEF("add-fd", HAS_ARG, QEMU_OPTION_add_fd,
--
2.11.0.259.g40922b1