libvirt/docs
Andrea Bolognani 3f01ecd830 docs: Improve documentation for dies and clusters
I've seen examples in the wild of the cluster attribute having
non-zero value on x86_64.

This is obviously quite confusing, but it's the information that
Linux exposes to userspace and we don't really have a way to tell
apart a valid die/cluster ID from a dummy one.

What ultimately matters is that the underlying assumptions about
topology are respected, which they are: in the x86_64 cases that
I have analyzed, for example, each "cluster" contained exactly
one core, so any program that would use this information to
influence guest topology decisions would be unaffected by the
additional level showing up in the hierarchy.

In an attempt to reduce confusion, remove any reference to any
specific value for the attributes having any special meaning
attached to it.

In fact, since there are plans to make it possible to create
guests with multiple CPU clusters on x86_64, rework the note
into a more generic warning cautioning users that an attribute
showing up here does not imply that the same attribute can be
used when defining a guest CPU topology.

Signed-off-by: Andrea Bolognani <abologna@redhat.com>
Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
2024-02-08 18:41:47 +01:00
..
css css: Move generic styles to 'generic.css' 2024-02-08 16:48:47 +01:00
fonts
gitdm
go
html docs: xsl: Properly propagate 'href_base' as XSL template parameter 2024-02-08 16:48:47 +01:00
images
js js: Separate the virt-tools blog planet loader code 2024-02-08 16:48:47 +01:00
kbase docs: fix typo in qemu-passthrough-security 2024-01-03 16:05:03 +00:00
logos
manpages virDomainBlockResize: Introduce VIR_DOMAIN_BLOCK_RESIZE_CAPACITY 2023-12-14 16:09:05 +01:00
404.rst
acl.rst
aclpolkit.rst
advanced-tests.rst tests: Rename 'qemuxml2argvtest' to 'qemuxmlconftest' 2024-01-17 17:31:12 +01:00
android-chrome-192x192.png
android-chrome-256x256.png
api_extension.rst
api.rst
apple-touch-icon.png
apps.rst
auditlog.rst
auth.rst
best-practices.rst
bindings.rst docs: update docs pointing to old mailing list addrs 2023-10-31 10:04:27 +00:00
browserconfig.xml
bugs.rst
cgroups.rst
ci-dashboard.rst
ci-runners.rst docs: ci-runners: Add a note on a new runner registration process 2023-10-11 09:43:09 +02:00
ci.rst docs: ci: Update the description on the integration CI GitLab variables 2023-10-11 09:43:09 +02:00
clangd.rst
coding-style.rst
committer-guidelines.rst
compiling.rst docs: compiling: Add a note about use of CFLAGS for optimization 2023-09-04 13:32:28 +02:00
contact.rst docs: update docs pointing to old mailing list addrs 2023-10-31 10:04:27 +00:00
contribute.rst
csharp.rst
daemons.rst
dbus.rst
docs.rst
downloads.rst docs: update docs pointing to old mailing list addrs 2023-10-31 10:04:27 +00:00
drivers.rst
drvbhyve.rst
drvch.rst
drvesx.rst
drvhyperv.rst
drvlxc.rst
drvnodedev.rst
drvopenvz.rst
drvqemu.rst
drvsecret.rst docs: Convert 'drvsecret' page to rST 2022-04-01 16:33:19 +02:00
drvtest.rst
drvvbox.rst
drvvirtuozzo.rst
drvvmware.rst
drvxen.rst
errors.rst
favicon-16x16.png
favicon-32x32.png
favicon.ico
firewall.rst
format.rst
formatbackup.rst
formatcaps.rst docs: Improve documentation for dies and clusters 2024-02-08 18:41:47 +01:00
formatcheckpoint.rst
formatdomain.rst conf: Introduce dynamicMemslots attribute for virtio-mem 2024-01-30 10:44:36 +01:00
formatdomaincaps.rst test_driver: Implement virConnectGetDomainCapabilities() 2023-09-21 08:45:31 +02:00
formatnetwork.rst network: Make virtual domains resolvable from the host 2024-02-07 14:19:42 +01:00
formatnetworkport.rst tests: remove explicit <driver name='vfio'/> from hostdev test cases 2024-01-07 23:59:00 -05:00
formatnode.rst
formatnwfilter.rst
formatsecret.rst
formatsnapshot.rst
formatstorage.rst
formatstoragecaps.rst
formatstorageencryption.rst
glib-adoption.rst
goals.rst
golang.rst
governance.rst
hacking.rst
hooks.rst bhyve: Feed hook scripts with domain XML 2023-09-04 11:03:33 +02:00
index.rst js: Separate the virt-tools blog planet loader code 2024-02-08 16:48:47 +01:00
issue-handling.rst
libvirt-go-xml.rst
libvirt-go.rst
logging.rst
macos.rst
manifest.json
meson.build meson: Rename build_tests -> tests_enabled 2023-10-26 11:31:25 +02:00
migration.rst
mstile-150x150.png
newapi.xsl docs: page.xsl: Split up 'href_base' for assets and links 2024-02-08 16:48:47 +01:00
newreposetup.rst docs: update docs pointing to old mailing list addrs 2023-10-31 10:04:27 +00:00
nss.rst
page.xsl docs: page.xsl: Split up 'href_base' for assets and links 2024-02-08 16:48:47 +01:00
pci-addresses.rst tests: remove explicit <driver name='vfio'/> from hostdev test cases 2024-01-07 23:59:00 -05:00
pci-hotplug.rst
platforms.rst
programming-languages.rst
python.rst
remote.rst
securityprocess.rst docs: update docs pointing to old mailing list addrs 2023-10-31 10:04:27 +00:00
site.xsl docs: page.xsl: Split up 'href_base' for assets and links 2024-02-08 16:48:47 +01:00
storage.rst
strategy.rst
styleguide.rst
submitting-patches.rst docs: update docs pointing to old mailing list addrs 2023-10-31 10:04:27 +00:00
support.rst
testapi.rst docs: update docs pointing to old mailing list addrs 2023-10-31 10:04:27 +00:00
testing.rst docs: testing: Adjust the docs on how to run container workloads locally 2023-10-11 09:43:09 +02:00
testtck.rst docs: testtck: Expand the 'Run TCK' section on making use of ci/jobs.sh 2023-10-11 09:43:09 +02:00
uri.rst
windows.rst