Changeset 104910 in vbox

Timestamp:

Jun 13, 2024 10:31:38 AM (7 months ago)

Author:

vboxsync

Message:

VMM/PGM: bugref:10703 Add PGM API for retreiving boot zeroed RAM ranges for Hyper-V paravirt provider.

Location:

trunk

Files:

• include/VBox/vmm/pgm.h (modified) (2 diffs)
• src/VBox/VMM/VMMR3/PGMPhys.cpp (modified) (1 diff)

trunk/include/VBox/vmm/pgm.h

@@ -743 +743 @@
 /** @} */
 
+/**
+ * A physical memory range.
+ *
+ * @note This layout adheres to to GIM Hyper-V specs (asserted while compiling
+ * GIM Hyper-V that uses the PGM API).
+ */
+typedef struct PGMPHYSRANGE
+{
+    /** The first address in the range. */
+    RTGCPHYS        GCPhysStart;
+    /** The number of pages in the range. */
+    uint64_t        cPages;
+} PGMPHYSRANGE;
+AssertCompileSize(PGMPHYSRANGE, 16);
+
+/**
+ * A list of physical memory ranges.
+ *
+ * @note This layout adheres to to GIM Hyper-V specs (asserted while compiling
+ * GIM Hyper-V that uses the PGM API).
+ */
+typedef struct PGMPHYSRANGES
+{
+    /** The number of ranges in the list. */
+    uint64_t        cRanges;
+    /** Array of physical memory ranges. */
+    RT_FLEXIBLE_ARRAY_EXTENSION
+    PGMPHYSRANGE    aRanges[RT_FLEXIBLE_ARRAY];
+} PGMPHYSRANGES;
+/** Pointer to a list of physical memory ranges. */
+typedef PGMPHYSRANGES *PPGMPHYSRANGES;
+/** Pointer to a const list of physical memory ranges. */
+typedef PGMPHYSRANGES const *PCPGMPHYSRANGES;
+
 
 VMM_INT_DECL(PGMPAGETYPE) PGMPhysGetPageType(PVMCC pVM, RTGCPHYS GCPhys);
@@ -1112 +1146 @@
 VMMR3DECL(int)      PGMR3PhysGetRange(PVM pVM, uint32_t iRange, PRTGCPHYS pGCPhysStart, PRTGCPHYS pGCPhysLast,
                                       const char **ppszDesc, bool *pfIsMmio);
+VMMR3_INT_DECL(int) PGMR3PhysGetRamBootZeroedRanges(PVM pVM, PPGMPHYSRANGES pRanges, uint32_t cMaxRanges);
 VMMR3DECL(int)      PGMR3QueryMemoryStats(PUVM pUVM, uint64_t *pcbTotalMem, uint64_t *pcbPrivateMem, uint64_t *pcbSharedMem, uint64_t *pcbZeroMem);
 VMMR3DECL(int)      PGMR3QueryGlobalMemoryStats(PUVM pUVM, uint64_t *pcbAllocMem, uint64_t *pcbFreeMem, uint64_t *pcbBallonedMem, uint64_t *pcbSharedMem);

trunk/src/VBox/VMM/VMMR3/PGMPhys.cpp

@@ -1501 +1501 @@
     PGM_UNLOCK(pVM);
     return VERR_OUT_OF_RANGE;
+}
+
+
+/**
+ * Gets RAM ranges that are supposed to be zero'ed at boot.
+ *
+ * This function gets all RAM ranges that are not ad hoc (ROM, MMIO, MMIO2) memory.
+ * The RAM hole (if any) is -NOT- included because we don't return 0s when it is
+ * read anyway.
+ *
+ * @returns VBox status code.
+ * @param   pVM             The cross context VM structure.
+ * @param   pRanges         Where to store the physical RAM ranges.
+ * @param   cMaxRanges      The maximum ranges that can be stored.
+ */
+VMMR3_INT_DECL(int) PGMR3PhysGetRamBootZeroedRanges(PVM pVM, PPGMPHYSRANGES pRanges, uint32_t cMaxRanges)
+{
+    VM_ASSERT_VALID_EXT_RETURN(pVM, VERR_INVALID_VM_HANDLE);
+    AssertPtrReturn(pRanges, VERR_INVALID_PARAMETER);
+    AssertReturn(cMaxRanges > 0, VERR_INVALID_PARAMETER);
+
+    int rc = VINF_SUCCESS;
+    uint32_t idxRange = 0;
+    PGM_LOCK_VOID(pVM);
+
+    /*
+     * The primary purpose of this API is the GIM Hyper-V hypercall which recommends (not
+     * requires) that the largest ranges are reported earlier. Therefore, here we iterate
+     * the ranges in reverse because in PGM the largest range is generally at the end.
+     */
+    uint32_t const cLookupEntries = RT_MIN(pVM->pgm.s.RamRangeUnion.cLookupEntries, RT_ELEMENTS(pVM->pgm.s.aRamRangeLookup));
+    for (int32_t idxLookup = cLookupEntries - 1; idxLookup >= 0; idxLookup--)
+    {
+        uint32_t const idRamRange = PGMRAMRANGELOOKUPENTRY_GET_ID(pVM->pgm.s.aRamRangeLookup[idxLookup]);
+        Assert(idRamRange < RT_ELEMENTS(pVM->pgm.s.apRamRanges));
+        PPGMRAMRANGE const pCur = pVM->pgm.s.apRamRanges[idRamRange];
+        AssertContinue(pCur);
+
+        if (!PGM_RAM_RANGE_IS_AD_HOC(pCur))
+        {
+            if (idxRange < cMaxRanges)
+            {
+                /* Combine with previous range if it is contiguous, otherwise add it as a new range. */
+                if (   idxRange > 0
+                    && pRanges->aRanges[idxRange - 1].GCPhysStart == pCur->GCPhysLast + 1U)
+                {
+                    pRanges->aRanges[idxRange - 1].GCPhysStart = pCur->GCPhys;
+                    pRanges->aRanges[idxRange - 1].cPages     += (pCur->cb >> GUEST_PAGE_SHIFT);
+                }
+                else
+                {
+                    pRanges->aRanges[idxRange].GCPhysStart = pCur->GCPhys;
+                    pRanges->aRanges[idxRange].cPages      = pCur->cb >> GUEST_PAGE_SHIFT;
+                    ++idxRange;
+                }
+            }
+            else
+            {
+                rc = VERR_BUFFER_OVERFLOW;
+                break;
+            }
+        }
+    }
+    pRanges->cRanges = idxRange;
+    PGM_UNLOCK(pVM);
+    return rc;
 }