Added description for new vcpu.<num>.halted statistics value.
While there, also added a description for vcpu.<num>.wait and
clarified the units displayed for time and wait.

Signed-off-by: Viktor Mihajlovski <>
Reviewed-by: Bjoern Walk <>
 tools/virsh.pod | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/tools/virsh.pod b/tools/virsh.pod
index 1fe4269..9e3a248 100644
--- a/tools/virsh.pod
+++ b/tools/virsh.pod
@@ -887,6 +887,9 @@ default all supported statistics groups are returned. 
 statistics groups flags are: I<--state>, I<--cpu-total>, I<--balloon>,
 I<--vcpu>, I<--interface>, I<--block>, I<--perf>.
+Note that - depending on the hypervisor type and version or the domain state
+- not all of the following statistics may be returned.
 When selecting the I<--state> group the following fields are returned:
 "state.state" - state of the VM, returned as number from virDomainState enum,
 "state.reason" - reason for entering given state, returned as int from
@@ -917,6 +920,10 @@ I<--vcpu> returns:
 "vcpu.<num>.state" - state of the virtual CPU <num>, as number
 from virVcpuState enum,
 "vcpu.<num>.time" - virtual cpu time spent by virtual CPU <num>
+ (in microseconds),
+"vcpu.<num>.wait" - virtual cpu time spent by virtual CPU <num>
+waiting on I/O (in microseconds),
+"vcpu.<num>.halted" - virtual CPU <num> is halted: yes or no
 I<--interface> returns:
 "net.count" - number of network interfaces on this domain,

libvir-list mailing list

Reply via email to