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 meson: Work around configure_file(copy:true) deprecation 2023-04-20 15:30:18 +02:00
gitdm
go docs: go: Add 'go-import' metadata via rST 2023-06-02 09:39:10 +02:00
html docs: xsl: Properly propagate 'href_base' as XSL template parameter 2024-02-08 16:48:47 +01:00
images meson: Work around configure_file(copy:true) deprecation 2023-04-20 15:30:18 +02:00
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 meson: Work around configure_file(copy:true) deprecation 2023-04-20 15:30:18 +02:00
manpages virDomainBlockResize: Introduce VIR_DOMAIN_BLOCK_RESIZE_CAPACITY 2023-12-14 16:09:05 +01:00
404.rst docs: Convert 404 page to rST 2023-02-21 10:58:59 +01:00
acl.rst docs: acl: Convert to 'rst' 2023-05-17 16:54:23 +02:00
aclpolkit.rst docs: acl: Convert to 'rst' 2023-05-17 16:54:23 +02:00
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 docs: apps: Add a new section for backup utilities and mention 'virtnbdbackup' 2023-04-03 11:09:39 +02:00
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 docs: expand clangd instructions 2023-07-17 10:43:29 -05:00
coding-style.rst coding style: Follow our own rule on comment style 2023-04-04 12:16:09 +02:00
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 docs: Missing "full-stop"/"period" on some bullet items 2023-07-14 15:19:10 +02:00
csharp.rst
daemons.rst
dbus.rst
docs.rst docs: Link to java.libvirt.org 2023-04-27 11:06:42 +02:00
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
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 qemu: add luks-any encryption support for RBD images 2023-03-16 15:19:36 +01:00
glib-adoption.rst
goals.rst
golang.rst docs: Add sub-page for all golang modules 2023-02-15 12:38:45 +01:00
governance.rst
hacking.rst docs: Advise running CI tests prior to submission 2023-07-14 15:19:24 +02:00
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 docs: go: Add 'go-import' metadata via rST 2023-06-02 09:39:10 +02:00
libvirt-go.rst docs: go: Add 'go-import' metadata via rST 2023-06-02 09:39:10 +02:00
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 Use 'libvirt.org' instead of 'www.libvirt.org' 2023-04-03 09:19:05 +02:00
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