ef809b76a6
- esxConnectListAllDomains: Don't propagate failure to lookup a single domain (RHEL-80606) - conf: parse interface/source/@dev for all interface types (with backend type='passt') (RHEL-82539) - libvirt-host: Clarify/fix description of the CPU frequency field (RHEL-86197) - virNodeGetInfo: Improve description of the case when fake data is reported (RHEL-86197) - manpages: virsh: Use disclaimer from 'virNodeGetInfo()' for 'virsh nodeinfo' (RHEL-86197) - esx: Accept empty "path" URI component same way as "/" (RHEL-86459) - qemu: Rename outgoingMigration parameter in various TPM functions (RHEL-86800) - qemu: Properly propagate migration state to TPM cleanup code (RHEL-86800) - qemuDomainBlockCopyCommon: Don't revoke access to file twice on failure (RHEL-7357) - qemuxmlconftest: Drop s390-default-cpu-...ccw-virtio-2.7 test cases (RHEL-72976) - tests: add capabilities for QEMU 10.0.0 on s390x (RHEL-72976) - qemu: Do NOT autoadd NUMA node for s390 (RHEL-72976) - qemu_command: Use qemuBuildVirtioDevProps() to build cmd line for virtio-mem and virtio-pmem (RHEL-72976) - qemuxmlconftest: Introduce memory-hotplug-virtio-mem-pci-s390x.xml (RHEL-72976) - qemu_caps: Introduce QEMU_CAPS_DEVICE_VIRTIO_MEM_CCW (RHEL-72976) - qemu: Validate virtio-mem-ccw (RHEL-72976) - qemu: Allow virtio-mem on CCW (RHEL-72976) - qemuxmlconftest: Introduce memory-hotplug-virtio-mem-ccw-s390x.xml (RHEL-72976) - qemu_domain_address: fix CCW virtio-mem hotplug (RHEL-72976) Resolves: RHEL-72976, RHEL-7357, RHEL-80606, RHEL-82539, RHEL-86197 Resolves: RHEL-86459, RHEL-86800
56 lines
2.3 KiB
Diff
56 lines
2.3 KiB
Diff
From 90859b9c9cda1ab3daa34847ac4608cf451102ce Mon Sep 17 00:00:00 2001
|
|
Message-ID: <90859b9c9cda1ab3daa34847ac4608cf451102ce.1744876588.git.jdenemar@redhat.com>
|
|
From: Peter Krempa <pkrempa@redhat.com>
|
|
Date: Mon, 7 Apr 2025 14:58:41 +0200
|
|
Subject: [PATCH] manpages: virsh: Use disclaimer from 'virNodeGetInfo()' for
|
|
'virsh nodeinfo'
|
|
|
|
Adapt the disclarimer about the data not being accurate in many cases
|
|
from the API docs to the virsh command using the aforementioned API.
|
|
|
|
Signed-off-by: Peter Krempa <pkrempa@redhat.com>
|
|
Reviewed-by: Michal Privoznik <mprivozn@redhat.com>
|
|
(cherry picked from commit 617e2dc3194204a88309e3da55bec8743a5df2ea)
|
|
|
|
https://issues.redhat.com/browse/RHEL-86197
|
|
---
|
|
docs/manpages/virsh.rst | 23 +++++++++++++++++++----
|
|
1 file changed, 19 insertions(+), 4 deletions(-)
|
|
|
|
diff --git a/docs/manpages/virsh.rst b/docs/manpages/virsh.rst
|
|
index 2e525d3fac..aea920b7a7 100644
|
|
--- a/docs/manpages/virsh.rst
|
|
+++ b/docs/manpages/virsh.rst
|
|
@@ -427,10 +427,25 @@ nodeinfo
|
|
nodeinfo
|
|
|
|
Returns basic information about the node, like number and type of CPU,
|
|
-and size of the physical memory. The output corresponds to virNodeInfo
|
|
-structure. Specifically, the "CPU socket(s)" field means number of CPU
|
|
-sockets per NUMA cell. The information libvirt displays is dependent
|
|
-upon what each architecture may provide.
|
|
+and size of the physical memory.
|
|
+
|
|
+Use of this command is strongly discouraged as the information provided
|
|
+is not guaranteed to be accurate on all hardware platforms.
|
|
+
|
|
+The *CPU frequency* value merely reflects the speed that the first CPU in the
|
|
+machine is currently running at. This speed may vary across CPUs and changes
|
|
+continually as the host OS throttles.
|
|
+
|
|
+The data structure used to fetch the data is not extensible thus only supports
|
|
+global nodes/sockets/cores/threads (sockets/cores/threads is per NUMA node)
|
|
+topology information. If the host CPU has any further groupings (e.g.
|
|
+dies, clusters, etc) or the NUMA topology is non-symmetrical the data structure
|
|
+can't faithfully represent the system. In such cases a fake topology
|
|
+(nodes = 1, sockets = 1, cores = number of host cpus, threads = 1) which
|
|
+only correctly represents the total host CPU count is reported.
|
|
+
|
|
+Recommended replacement is to use the *capabilities* command which reports
|
|
+the data (except frequency) under ``/capabilities/host/topology`` XPath.
|
|
|
|
|
|
nodecpumap
|
|
--
|
|
2.49.0
|