From: Assaf Admi Date: Tue, 7 May 2024 08:58:06 +0000 (+0300) Subject: docs: Document that 'vcpu.delay' statistic is in nanoseconds X-Git-Tag: v11.1.0-rc1~164 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f6d76aad80f1aa7e039f3d7c4521948630ad5377;p=thirdparty%2Flibvirt.git docs: Document that 'vcpu.delay' statistic is in nanoseconds Add nanoseconds units for vcpu.delay doc, as it's based on '/proc//task//schedstat' (see 'qemuGetSchedstatDelay()'). 'schedstat' is in nanoseconds, according to https://docs.kernel.org/scheduler/sched-stats.html#proc-pid-schedstat. Signed-off-by: aadmi Reviewed-by: Peter Krempa --- diff --git a/docs/manpages/virsh.rst b/docs/manpages/virsh.rst index bf0436621b..868b354b2f 100644 --- a/docs/manpages/virsh.rst +++ b/docs/manpages/virsh.rst @@ -2441,7 +2441,7 @@ When selecting the *--state* group the following fields are returned: no (may indicate the processor is idle or even disabled, depending on the architecture) * ``vcpu..delay`` - time the vCPU thread was enqueued by the - host scheduler, but was waiting in the queue instead of running. + host scheduler, but was waiting in the queue instead of running (in nanoseconds). Exposed to the VM as a steal time. This group of statistics also reports additional hypervisor-originating per-vCPU diff --git a/src/libvirt-domain.c b/src/libvirt-domain.c index efccafc4d2..088e486b6b 100644 --- a/src/libvirt-domain.c +++ b/src/libvirt-domain.c @@ -12331,7 +12331,7 @@ virConnectGetDomainCapabilities(virConnectPtr conn, * "vcpu..delay" - time the vCPU thread was enqueued by the * host scheduler, but was waiting in the queue * instead of running. Exposed to the VM as a steal - * time. + * time. (in nanoseconds) * * This group of statistics also reports additional hypervisor-originating * per-vCPU stats. The hypervisor-specific statistics in this group have the