]> git.ipfire.org Git - thirdparty/libvirt.git/commitdiff
docs: Document that 'vcpu.delay' statistic is in nanoseconds
authorAssaf Admi <aadmi@redhat.com>
Tue, 7 May 2024 08:58:06 +0000 (11:58 +0300)
committerPeter Krempa <pkrempa@redhat.com>
Wed, 29 Jan 2025 11:42:27 +0000 (12:42 +0100)
Add nanoseconds units for vcpu.delay doc, as it's based on
'/proc/<pid>/task/<tid>/schedstat' (see 'qemuGetSchedstatDelay()').

'schedstat' is in nanoseconds, according to
https://docs.kernel.org/scheduler/sched-stats.html#proc-pid-schedstat.

Signed-off-by: aadmi <aadmi@redhat.com>
Reviewed-by: Peter Krempa <pkrempa@redhat.com>
docs/manpages/virsh.rst
src/libvirt-domain.c

index bf0436621b9653cbc1a727b8080a022e5d7d3790..868b354b2fae094db64f548501cbbcb1825364cb 100644 (file)
@@ -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.<num>.delay`` - time the vCPU <num> 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
index efccafc4d2f2c7b5c8f2571bd6c58c8cf2f965b1..088e486b6b7b77c79a89d915ae52fe831b48112c 100644 (file)
@@ -12331,7 +12331,7 @@ virConnectGetDomainCapabilities(virConnectPtr conn,
  *     "vcpu.<num>.delay" - time the vCPU <num> 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