add documentation for multi-core features

Message ID
State Superseded
Headers show

Commit Message

Andre Przywara Aug. 28, 2009, 8:49 a.m.
extend QEMU's internal help and man page to cover the recently
added multi-core feature.

Signed-off-by: Andre Przywara <>
 qemu-options.hx |   14 +++++++++++---
 1 files changed, 11 insertions(+), 3 deletions(-)


missed that part, that should have been in the original patch series.



diff --git a/qemu-options.hx b/qemu-options.hx
index 0c2b310..ce38a3b 100644
--- a/qemu-options.hx
+++ b/qemu-options.hx
@@ -39,15 +39,23 @@  Select CPU model (-cpu ? for list and additional feature selection)
-    "-smp n[,maxcpus=cpus]\n"
+    "-smp n[,maxcpus=cpus][,cores=cores][,threads=threads][,sockets=sockets]\n"
     "                set the number of CPUs to 'n' [default=1]\n"
     "                maxcpus= maximum number of total cpus, including\n"
-    "                offline CPUs for hotplug etc.\n")
+    "                  offline CPUs for hotplug etc.\n"
+    "                cores= number of CPU cores on one socket\n"
+    "                threads= number of threads on one CPU core\n"
+    "                sockets= number of discrete sockets in the system\n")
-@item -smp @var{n}
+@item -smp @var{n}[,cores=@var{cores}][,threads=@var{threads}][,sockets=@var{sockets}][,maxcpus=@var{maxcpus}]
 Simulate an SMP system with @var{n} CPUs. On the PC target, up to 255
 CPUs are supported. On Sparc32 target, Linux limits the number of usable CPUs
 to 4.
+For the PC target, the number of @var{cores} per socket, the number
+of @var{threads} per cores and the total number of @var{sockets} can be
+specified. Missing values will be computed. If any on the three values is
+given, the total number of CPUs @var{n} can be omitted. @var{maxcpus}
+specifies the maximum number of hotpluggable CPUs.
 DEF("numa", HAS_ARG, QEMU_OPTION_numa,