summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorDaniel P. Berrangé <berrange@redhat.com>2021-10-29 13:27:35 +0100
committerCole Robinson <crobinso@redhat.com>2022-01-20 14:16:38 -0500
commit9a578e1ac58eccd7b7a8123ce7fe22cbf8080b3a (patch)
tree2af67b4f267cc70158b53297b7ca9f632784496c /man
parente1c8866163a2861f79a08ce4e1487fc84b7d1ec1 (diff)
downloadvirt-manager-9a578e1ac58eccd7b7a8123ce7fe22cbf8080b3a.tar.gz
virtinst: prefer cores when exposing topology to the guest
In real world silicon though it is rare to have high socket/die counts, but common to have huge core counts. Some OS will even refuse to use sockets over a certain count. Thus we prefer to expose cores to the guest rather than sockets as the default for missing fields. This matches a recent change made in QEMU for new machine types commit 4a0af2930a4e4f64ce551152fdb4b9e7be106408 Author: Yanan Wang <wangyanan55@huawei.com> Date: Wed Sep 29 10:58:09 2021 +0800 machine: Prefer cores over sockets in smp parsing since 6.2 Closes: https://github.com/virt-manager/virt-manager/issues/155 Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
Diffstat (limited to 'man')
-rw-r--r--man/virt-install.rst6
1 files changed, 4 insertions, 2 deletions
diff --git a/man/virt-install.rst b/man/virt-install.rst
index c51303cc..85070314 100644
--- a/man/virt-install.rst
+++ b/man/virt-install.rst
@@ -290,8 +290,10 @@ the guest will be able to hotplug up to MAX vcpus while the guest is running,
but will startup with VCPUS.
CPU topology can additionally be specified with sockets, dies, cores, and threads.
-If values are omitted, the rest will be autofilled preferring sockets over
-cores over threads.
+If values are omitted, the rest will be autofilled preferring cores over sockets
+over threads. Cores are preferred because this matches the characteristics of
+modern real world silicon and thus a better fit for what guest OS will be
+expecting to deal with.
'cpuset' sets which physical cpus the guest can use. ``CPUSET`` is a comma
separated list of numbers, which can also be specified in ranges or cpus