Changeset 99196 in vbox for trunk/include/VBox/vmm

Timestamp:

Mar 28, 2023 1:06:05 PM (20 months ago)

Author:

vboxsync

Message:

VMM: Start on system register handling for ARMv8 (which is ver similar to how we handle MSR accesses on x86), bugref:10385

File:

• trunk/include/VBox/vmm/cpum-armv8.h (modified) (2 diffs)

trunk/include/VBox/vmm/cpum-armv8.h

@@ -48 +48 @@
  * @{
  */
+
+
+/**
+ * System register read functions.
+ */
+typedef enum CPUMSYSREGRDFN
+{
+    /** Invalid zero value. */
+    kCpumSysRegRdFn_Invalid = 0,
+    /** Return the CPUMMSRRANGE::uValue. */
+    kCpumSysRegRdFn_FixedValue,
+    /** Alias to the system register range starting at the system register given by
+     * CPUMSYSREGRANGE::uValue.  Must be used in pair with
+     * kCpumSysRegWrFn_Alias. */
+    kCpumSysRegRdFn_Alias,
+    /** Write only register, all read attempts cause an exception. */
+    kCpumSysRegRdFn_WriteOnly,
+
+    /** End of valid system register read function indexes. */
+    kCpumSysRegRdFn_End
+} CPUMSYSREGRDFN;
+
+
+/**
+ * System register write functions.
+ */
+typedef enum CPUMSYSREGWRFN
+{
+    /** Invalid zero value. */
+    kCpumSysRegWrFn_Invalid = 0,
+    /** Writes are ignored. */
+    kCpumSysRegWrFn_IgnoreWrite,
+    /** Writes cause an exception. */
+    kCpumSysRegWrFn_ReadOnly,
+    /** Alias to the system register range starting at the system register given by
+     * CPUMSYSREGRANGE::uValue.  Must be used in pair with
+     * kCpumSysRegRdFn_Alias. */
+    kCpumSysRegWrFn_Alias,
+
+    /** End of valid system register write function indexes. */
+    kCpumSysRegWrFn_End
+} CPUMSYSREGWRFN;
+
+
+/**
+ * System register range.
+ *
+ * @note This is very similar to how x86/amd64 MSRs are handled.
+ */
+typedef struct CPUMSYSREGRANGE
+{
+    /** The first system register. [0] */
+    uint16_t    uFirst;
+    /** The last system register. [2] */
+    uint16_t    uLast;
+    /** The read function (CPUMMSRRDFN). [4] */
+    uint16_t    enmRdFn;
+    /** The write function (CPUMMSRWRFN). [6] */
+    uint16_t    enmWrFn;
+    /** The offset of the 64-bit system register value relative to the start of CPUMCPU.
+     * UINT16_MAX if not used by the read and write functions.  [8] */
+    uint32_t    offCpumCpu : 24;
+    /** Reserved for future hacks. [11] */
+    uint32_t    fReserved : 8;
+    /** Padding/Reserved. [12] */
+    uint32_t    u32Padding;
+    /** The init/read value. [16]
+     * When enmRdFn is kCpumMsrRdFn_INIT_VALUE, this is the value returned on RDMSR.
+     * offCpumCpu must be UINT16_MAX in that case, otherwise it must be a valid
+     * offset into CPUM. */
+    uint64_t    uValue;
+    /** The bits to ignore when writing. [24]   */
+    uint64_t    fWrIgnMask;
+    /** The bits that will cause an exception when writing. [32]
+     * This is always checked prior to calling the write function.  Using
+     * UINT64_MAX effectively marks the MSR as read-only. */
+    uint64_t    fWrExcpMask;
+    /** The register name, if applicable. [32] */
+    char        szName[56];
+
+    /** The number of reads. */
+    STAMCOUNTER cReads;
+    /** The number of writes. */
+    STAMCOUNTER cWrites;
+    /** The number of times ignored bits were written. */
+    STAMCOUNTER cIgnoredBits;
+    /** The number of exceptions generated. */
+    STAMCOUNTER cExcp;
+} CPUMSYSREGRANGE;
+#ifndef VBOX_FOR_DTRACE_LIB
+AssertCompileSize(CPUMSYSREGRANGE, 128);
+#endif
+/** Pointer to an system register range. */
+typedef CPUMSYSREGRANGE *PCPUMSYSREGRANGE;
+/** Pointer to a const system register range. */
+typedef CPUMSYSREGRANGE const *PCCPUMSYSREGRANGE;
+
 
 /**
@@ -155 +252 @@
 /** @} */
 
+
+#ifndef VBOX_FOR_DTRACE_LIB
+
+/** @name Guest Register Getters.
+ * @{ */
+VMMDECL(VBOXSTRICTRC)   CPUMQueryGuestSysReg(PVMCPUCC pVCpu, uint32_t idSysReg, uint64_t *puValue);
+VMMDECL(VBOXSTRICTRC)   CPUMSetGuestSysReg(PVMCPUCC pVCpu, uint32_t idSysReg, uint64_t uValue);
+/** @} */
+
+#endif
+
 /** @} */
 RT_C_DECLS_END