Changeset 72300 in vbox for trunk/include/iprt

Timestamp:

May 23, 2018 3:13:06 PM (7 years ago)

Author:

vboxsync

Message:

NEM,STAM: Partition memory statistics for NEM. bugref:9044

• STAM: Redid the way we handle statistics requiring fetching data from ring-0 (or elsewhere) by introducing a refresh group concept. We'll refresh the statistics for a group if needed and only once per enumeration/query. There's a new registration API for these.
• NEM: Added memory balance statistics for the partition. Some failed fumbling thru VID.DLL/SYS, before realizing that hypercall is the only way to get at them.
• NEM: Added a hypervisor input/output page buffer for non-EMT threads so we can get statistics. Put the related data and code into separate structure to save duplication.

Location:

trunk/include/iprt/nt

Files:

• hyperv.h (modified) (6 diffs)
• vid.h (modified) (2 diffs)

trunk/include/iprt/nt/hyperv.h

@@ -327 +327 @@
 
 
+/** Hyper-V NUMA node ID.
+ * On systems without NUMA, i.e. a single node, it uses 0 as identifier.  */
+typedef uint32_t HV_PROXIMITY_DOMAIN_ID;
+/** Pointer to NUMA node ID. */
+typedef HV_PROXIMITY_DOMAIN_ID *PHV_PROXIMITY_DOMAIN_ID;
+
+/** Hyper-V NUMA flags. */
+typedef struct
+{
+    uint32_t    ProximityPreferred      : 1;    /**< When set, allocations may come from other NUMA nodes.  */
+    uint32_t    Reserved                : 30;   /**< Reserved for future (as of circa v2). */
+    uint32_t    ProxyimityInfoValid     : 1;    /**< Set if the NUMA information is valid. */
+} HV_PROXIMITY_DOMAIN_FLAGS;
+/** Pointer to Hyper-V NUMA flags. */
+typedef HV_PROXIMITY_DOMAIN_FLAGS *PHV_PROXIMITY_DOMAIN_FLAGS;
+
+/** Hyper-V NUMA information. */
+typedef struct
+{
+    HV_PROXIMITY_DOMAIN_ID      Id;             /**< NUMA node identifier.  */
+    HV_PROXIMITY_DOMAIN_FLAGS   Flags;          /**< NUMA flags. */
+} HV_PROXIMITY_DOMAIN_INFO;
+/** Pointer to Hyper-V NUMA information. */
+typedef HV_PROXIMITY_DOMAIN_INFO *PHV_PROXIMITY_DOMAIN_INFO;
+
+/** Input for HvCallGetMemoryBalance. */
+typedef struct
+{
+    HV_PARTITION_ID             TargetPartitionId;
+    HV_PROXIMITY_DOMAIN_INFO    ProximityDomainInfo;
+} HV_INPUT_GET_MEMORY_BALANCE;
+AssertCompileSize(HV_INPUT_GET_MEMORY_BALANCE, 16);
+/** Pointer to the input for HvCallGetMemoryBalance. */
+typedef HV_INPUT_GET_MEMORY_BALANCE *PHV_INPUT_GET_MEMORY_BALANCE;
+
+/** Output for HvCallGetMemoryBalance. */
+typedef struct
+{
+    uint64_t                    PagesAvailable;
+    uint64_t                    PagesInUse;
+} HV_OUTPUT_GET_MEMORY_BALANCE;
+/** Pointer to the output for HvCallGetMemoryBalance. */
+typedef HV_OUTPUT_GET_MEMORY_BALANCE *PHV_OUTPUT_GET_MEMORY_BALANCE;
+
+
 /** @name Flags used with HvCallMapGpaPages and HvCallMapSparseGpaPages.
  * @note There seems to be a more flags defined after v2.
@@ -1053 +1098 @@
 
 
-/** Input for HvCallGetVpRegister. */
+/** Input for HvCallGetVpRegisters. */
 typedef struct
 {
@@ -1064 +1109 @@
 } HV_INPUT_GET_VP_REGISTERS;
 AssertCompileMemberOffset(HV_INPUT_GET_VP_REGISTERS, Names, 16);
-/** Pointer to input for HvCallGetVpRegister. */
+/** Pointer to input for HvCallGetVpRegisters. */
 typedef HV_INPUT_GET_VP_REGISTERS *PHV_INPUT_GET_VP_REGISTERS;
-/* Output for HvCallGetVpRegister is an array of HV_REGISTER_VALUE parallel to HV_INPUT_GET_VP_REGISTERS::Names. */
-
-
-/** Register and value pair for HvCallSetVpRegister. */
+/* Output for HvCallGetVpRegisters is an array of HV_REGISTER_VALUE parallel to HV_INPUT_GET_VP_REGISTERS::Names. */
+
+
+/** Register and value pair for HvCallSetVpRegisters. */
 typedef struct
 {
@@ -1079 +1124 @@
 AssertCompileSize(HV_REGISTER_ASSOC, 32);
 AssertCompileMemberOffset(HV_REGISTER_ASSOC, Value, 16);
-/** Pointer to a register and value pair for HvCallSetVpRegister. */
+/** Pointer to a register and value pair for HvCallSetVpRegisters. */
 typedef HV_REGISTER_ASSOC *PHV_REGISTER_ASSOC;
 /** Helper for clearing the alignment padding members. */
@@ -1088 +1133 @@
     do { (a_pRegAssoc)->Pad0 = 0; (a_pRegAssoc)->Pad1 = 0; (a_pRegAssoc)->Value.Reg128.High64 = 0; } while (0)
 
-/** Input for HvCallSetVpRegister. */
+/** Input for HvCallSetVpRegisters. */
 typedef struct
 {
@@ -1098 +1143 @@
 } HV_INPUT_SET_VP_REGISTERS;
 AssertCompileMemberOffset(HV_INPUT_SET_VP_REGISTERS, Elements, 16);
-/** Pointer to input for HvCallSetVpRegister. */
+/** Pointer to input for HvCallSetVpRegisters. */
 typedef HV_INPUT_SET_VP_REGISTERS *PHV_INPUT_SET_VP_REGISTERS;
 

trunk/include/iprt/nt/vid.h

@@ -165 +165 @@
  * put (??) it into that memory mapping.
  *
- * @returns Success indicator (details in LastStatusValue and LastErrorValue).
+ * @returns Success indicator (details in LastErrorValue).
  *
  * @param   hPartition  The partition handle.
@@ -205 +205 @@
  * build 17101: eb vid+12180 0f 84 98 00 00 00
  *
- * @retval STATUS_NOT_IMPLEMENTED
+ * @retval  ERROR_NOT_IMPLEMENTED
+ *
+ * @remarks VidExoFastIoControlPartition probably disapproves of this too.  It
+ *          could be very handy for debugging upon occation.
  */
 DECLIMPORT(BOOL) VIDAPI VidGetVirtualProcessorRunningStatus(VID_PARTITION_HANDLE hPartition, HV_VP_INDEX iCpu,
                                                             VID_PROCESSOR_STATUS *penmStatus);
 
-
+/**
+ * For query virtual processor registers and other state information.
+ *
+ * @returns Success indicator (details in LastErrorValue).
+ */
 DECLIMPORT(BOOL) VIDAPI VidGetVirtualProcessorState(VID_PARTITION_HANDLE hPartition, HV_VP_INDEX iCpu,
                                                     HV_REGISTER_NAME const *paRegNames, uint32_t cRegisters,
                                                     HV_REGISTER_VALUE *paRegValues);
 
+/**
+ * For setting virtual processor registers and other state information.
+ *
+ * @returns Success indicator (details in LastErrorValue).
+ */
 DECLIMPORT(BOOL) VIDAPI VidSetVirtualProcessorState(VID_PARTITION_HANDLE hPartition, HV_VP_INDEX iCpu,
                                                     HV_REGISTER_NAME const *paRegNames, uint32_t cRegisters,
                                                     HV_REGISTER_VALUE const *paRegValues);
 
+/**
+ * Wrapper around the HvCallGetMemoryBalance hypercall.
+ *
+ * When VID.SYS processes the request, it will also query
+ * HvPartitionPropertyVirtualTlbPageCount, so we're passing a 3rd return
+ * parameter in case the API is ever extended to match the I/O control.
+ *
+ * @returns Success indicator (details in LastErrorValue).
+ * @retval  ERROR_NOT_IMPLEMENTED for exo partitions.
+ *
+ * @param   hPartition          The partition handle.
+ * @param   pcPagesAvailable    Where to return the number of unused pages
+ *                              still available to the partition.
+ * @param   pcPagesInUse        Where to return the number of pages currently
+ *                              in use by the partition.
+ * @param   pReserved           Pointer to dummy value, just in case they
+ *                              modify the API to include the nested TLB size.
+ *
+ * @note    Not available for exo partitions, unfortunately.  The
+ *          VidExoFastIoControlPartition function deflects it, failing it with
+ *          STATUS_NOT_IMPLEMENTED / ERROR_NOT_IMPLEMENTED.
+ */
+DECLIMPORT(BOOL) VIDAPI VidGetHvMemoryBalance(VID_PARTITION_HANDLE hPartition, uint64_t *pcPagesAvailable,
+                                              uint64_t *pcPagesInUse, uint64_t *pReserved);
+
 RT_C_DECLS_END
 #endif /* IN_RING3 */