[PATCHv2 3/6] virNodeGetCPUTime: Implement public API

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



virNodeGetCPUTime: Implement public API

Signed-off-by: Minoru Usui <usui@xxxxxxxxxxxxxxxxx>
---
 src/libvirt.c |   70 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 70 insertions(+), 0 deletions(-)

diff --git a/src/libvirt.c b/src/libvirt.c
index 8be18d4..a65bfc6 100644
--- a/src/libvirt.c
+++ b/src/libvirt.c
@@ -4260,6 +4260,76 @@ error:
 }
 
 /**
+ * virNodeGetCpuTime:
+ * @stats: nr_stats-sized array of stat structures (returned)
+ * @nr_stats: number of cpu time statistics requested of the node.
+ * @flags: unused, always pass 0
+ *
+ * This function provides cpu time statistics of the node.
+ *
+ * Up to 'nr_stats' elements of 'stats' will be populated with cpu time statistics
+ * of the node.  Only statistics supported by the driver, and this version of
+ * libvirt will be returned.
+ *
+ * Cpu time Statistics:
+ *
+ * VIR_NODE_CPU_TIME_KERNEL:
+ *     The cumulative CPU time which spends by kernel,
+ *     when the node booting up.(nanoseconds)
+ * VIR_NODE_CPU_TIME_USER:
+ *     The cumulative CPU time which spends by user processes,
+ *     when the node booting up.(nanoseconds)
+ * VIR_NODE_CPU_TIME_IDLE:
+ *     The cumulative idle CPU time, when the node booting up.(nanoseconds)
+ * VIR_NODE_CPU_TIME_IOWAIT:
+ *     The cumulative I/O wait CPU time, when the node booting up.(nanoseconds)
+ * VIR_NODE_CPU_TIME_UTILIZATION:
+ *     The CPU utilization. The usage value is in percent and 100%
+ *     represents all CPUs on the server.
+ *
+ * Returns: The number of stats provided or -1 in case of failure.
+ */
+int virNodeGetCpuTime (virConnectPtr conn, virNodeCpuTimePtr stats,
+                          unsigned int nr_stats, unsigned int flags)
+{
+    unsigned long nr_stats_ret = 0;
+
+    VIR_DEBUG("conn=%p, stats=%p, nr_stats=%u", conn, stats, nr_stats);
+
+    virResetLastError();
+
+    if (!VIR_IS_CONNECT (conn)) {
+        virLibConnError(VIR_ERR_INVALID_CONN, __FUNCTION__);
+        virDispatchError(NULL);
+        return 0;
+    }
+
+    if (flags != 0) {
+        virLibConnError(VIR_ERR_INVALID_ARG, _("flags must be zero"));
+        goto error;
+    }
+
+    if (!stats || nr_stats == 0)
+        return 0;
+
+    if (nr_stats > VIR_NODE_CPU_TIME_NR)
+        nr_stats = VIR_NODE_CPU_TIME_NR;
+
+    if (conn->driver->nodeGetCpuTime) {
+        nr_stats_ret = conn->driver->nodeGetCpuTime (conn, stats, nr_stats, flags);
+        if (nr_stats_ret == -1)
+            goto error;
+        return nr_stats_ret;
+    }
+
+    virLibConnError(VIR_ERR_NO_SUPPORT, __FUNCTION__);
+
+error:
+    virDispatchError(conn);
+    return -1;
+}
+
+/**
  * virNodeGetFreeMemory:
  * @conn: pointer to the hypervisor connection
  *
-- 
1.7.1

-- 
Minoru Usui <usui@xxxxxxxxxxxxxxxxx>

--
libvir-list mailing list
libvir-list@xxxxxxxxxx
https://www.redhat.com/mailman/listinfo/libvir-list


[Index of Archives]     [Virt Tools]     [Libvirt Users]     [Lib OS Info]     [Fedora Users]     [Fedora Desktop]     [Fedora SELinux]     [Big List of Linux Books]     [Yosemite News]     [KDE Users]     [Fedora Tools]