From a6500ee4f2f0db3fb8c408075b7dbcd77f7669d2 Mon Sep 17 00:00:00 2001 From: Peter Krempa Date: Mon, 15 Sep 2014 17:17:17 +0200 Subject: [PATCH] lib: Document that virConnectGetAllDomainStats may omit some stats fields Add a note to make the users aware that some stats groups or fields may be missing in certain cases. --- src/libvirt.c | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/src/libvirt.c b/src/libvirt.c index 92f4c217b5..98f7cc84ac 100644 --- a/src/libvirt.c +++ b/src/libvirt.c @@ -21657,6 +21657,11 @@ virConnectGetDomainCapabilities(virConnectPtr conn, * "block..errors" - Xen only: the 'oo_req' value as * unsigned long long. * + * Note that entire stats groups or individual stat fields may be missing from + * the output in case they are not supported by the given hypervisor, are not + * applicable for the current state of the guest domain, or their retrieval + * was not successful. + * * Using 0 for @stats returns all stats groups supported by the given * hypervisor. * -- 2.39.5