From: Martin Kletzander <mkletzan@redhat.com>
Date: Tue, 25 Feb 2025 14:36:03 +0000 (+0100)
Subject: Add load average information type into virDomainGetGuestInfo
X-Git-Tag: v11.2.0-rc1~321
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=c52c449fd40c7263896d5f17129207b815c3a09c;p=thirdparty%2Flibvirt.git

Add load average information type into virDomainGetGuestInfo

The public API part.

Signed-off-by: Martin Kletzander <mkletzan@redhat.com>
Reviewed-by: Peter Krempa <pkrempa@redhat.com>
---

diff --git a/include/libvirt/libvirt-domain.h b/include/libvirt/libvirt-domain.h
index f5420bca6e..2d27f96be9 100644
--- a/include/libvirt/libvirt-domain.h
+++ b/include/libvirt/libvirt-domain.h
@@ -6455,6 +6455,7 @@ typedef enum {
     VIR_DOMAIN_GUEST_INFO_FILESYSTEM = (1 << 4), /* return filesystem information (Since: 5.7.0) */
     VIR_DOMAIN_GUEST_INFO_DISKS = (1 << 5), /* return disks information (Since: 7.0.0) */
     VIR_DOMAIN_GUEST_INFO_INTERFACES = (1 << 6), /* return interfaces information (Since: 7.10.0) */
+    VIR_DOMAIN_GUEST_INFO_LOAD = (1 << 7), /* return load averages (Since: 11.2.0) */
 } virDomainGuestInfoTypes;
 
 int virDomainGetGuestInfo(virDomainPtr domain,
diff --git a/src/libvirt-domain.c b/src/libvirt-domain.c
index 072cc32255..ae15ab1e5a 100644
--- a/src/libvirt-domain.c
+++ b/src/libvirt-domain.c
@@ -13292,6 +13292,14 @@ virDomainSetVcpu(virDomainPtr domain,
  *      "if.<num>.addr.<num1>.addr" - the IP address of addr <num1>
  *      "if.<num>.addr.<num1>.prefix" - the prefix of IP address of addr <num1>
  *
+ * VIR_DOMAIN_GUEST_INFO_LOAD:
+ *  Returns load (the number of processes in the runqueue or waiting for disk
+ *  I/O) as double values:
+ *
+ *      "load.1m" - load averaged over 1 minute
+ *      "load.5m" - load averaged over 5 minutes
+ *      "load.15m" - load averaged over 15 minutes
+ *
  * Using 0 for @types returns all information groups supported by the given
  * hypervisor.
  *