Changeset 80114 in vbox for trunk/src/VBox/Main

Timestamp:

Aug 2, 2019 9:04:00 PM (6 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

132555

Message:

Main/IMachineDebugger: Added method for getting the CPU load (as seen by the VMM) in pct over a period (typically 1 sec).

Location:

trunk/src/VBox/Main

Files:

• idl/VirtualBox.xidl (modified) (2 diffs)
• include/MachineDebuggerImpl.h (modified) (1 diff)
• src-client/MachineDebuggerImpl.cpp (modified) (2 diffs)

trunk/src/VBox/Main/idl/VirtualBox.xidl

@@ -19807 +19807 @@
   <interface
     name="IMachineDebugger" extends="$unknown"
-    uuid="e91bb944-f211-4bd5-b44c-8f1d0beafa13"
+    uuid="00ae6af4-00a7-4104-0009-49bc00b2da80"
     wsmap="managed"
     reservedMethods="16" reservedAttributes="16"
@@ -20173 +20173 @@
       <param name="stats" type="wstring" dir="return">
         <desc>The XML document containing the statistics.</desc>
+      </param>
+    </method>
+
+    <method name="getCPULoad">
+      <desc>
+        Get the load percentages (as observed by the VMM) for all virtual CPUs
+        or a specific one.
+      </desc>
+      <param name="cpuId" type="unsigned long" dir="in">
+        <desc>The ID of the virtual CPU to retrieve stats for, pass 0x7fffffff
+          or higher for the average accross all CPUs.</desc>
+      </param>
+      <param name="pctExecuting" type="unsigned long" dir="out">
+        <desc>Percentage of the interval that the CPU(s) spend executing guest code.</desc>
+      </param>
+      <param name="pctHalted" type="unsigned long" dir="out">
+        <desc>Percentage of the interval that the CPU(s) spend halted.</desc>
+      </param>
+      <param name="pctOther" type="unsigned long" dir="out">
+        <desc>Percentage of the interval that the CPU(s) preempted by the host
+        scheduler, on virtualization overhead and on other tasks.</desc>
+      </param>
+      <param name="msInterval" type="long long" dir="return">
+        <desc>The interval the percentage was calculated over in milliseconds</desc>
       </param>
     </method>

trunk/src/VBox/Main/include/MachineDebuggerImpl.h

@@ -133 +133 @@
                      BOOL aWithDescriptions,
                      com::Utf8Str &aStats);
+    HRESULT getCPULoad(ULONG aCpuId, ULONG *aPctExecuting, ULONG *aPctHalted, ULONG *aPctOther, LONG64 *aMsInterval) RT_OVERRIDE;
 
     // private methods

trunk/src/VBox/Main/src-client/MachineDebuggerImpl.cpp

@@ -1541 +1541 @@
 {
     Console::SafeVMPtrQuiet ptrVM(mParent);
-
     if (!ptrVM.isOk())
         return setError(VBOX_E_INVALID_VM_STATE, "Machine is not running");
@@ -1562 +1561 @@
 
 
+/** Wrapper around TMR3GetCpuLoadPercents. */
+HRESULT MachineDebugger::getCPULoad(ULONG aCpuId, ULONG *aPctExecuting, ULONG *aPctHalted, ULONG *aPctOther, LONG64 *aMsInterval)
+{
+    HRESULT hrc;
+    Console::SafeVMPtrQuiet ptrVM(mParent);
+    if (ptrVM.isOk())
+    {
+        uint8_t uPctExecuting = 0;
+        uint8_t uPctHalted    = 0;
+        uint8_t uPctOther     = 0;
+        uint64_t msInterval   = 0;
+        int vrc = TMR3GetCpuLoadPercents(ptrVM.rawUVM(), aCpuId >= UINT32_MAX / 2 ? VMCPUID_ALL : aCpuId,
+                                         &msInterval, &uPctExecuting, &uPctHalted, &uPctOther);
+        if (RT_SUCCESS(vrc))
+        {
+            *aPctExecuting = uPctExecuting;
+            *aPctHalted    = uPctHalted;
+            *aPctOther     = uPctOther;
+            *aMsInterval   = msInterval;
+            hrc = S_OK;
+        }
+        else
+            hrc = setErrorVrc(vrc);
+    }
+    else
+        hrc = setError(VBOX_E_INVALID_VM_STATE, "Machine is not running");
+    return hrc;
+}
+
+
 // public methods only for internal purposes
 /////////////////////////////////////////////////////////////////////////////