Changeset 86102 in vbox

Timestamp:

Sep 13, 2020 8:26:02 AM (5 years ago)

Author:

vboxsync

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

140334

Message:

VMM/DBGFOS: Add preliminary WinNT specific interface to let the KD remote stub communicate with the OS digger plugin

Location:

trunk

Files:

• include/VBox/vmm/dbgf.h (modified) (2 diffs)
• src/VBox/VMM/VMMR3/DBGFOS.cpp (modified) (4 diffs)

trunk/include/VBox/vmm/dbgf.h

@@ -2173 +2173 @@
     /** Kernel message log - DBGFOSIDMESG. */
     DBGFOSINTERFACE_DMESG,
+    /** Windows NT specifics (for the communication with the KD debugger stub). */
+    DBGFOSINTERFACE_WINNT,
     /** The end of the valid entries. */
     DBGFOSINTERFACE_END,
@@ -2361 +2363 @@
 /** Magic value for DBGFOSIDMESG::32Magic and DBGFOSIDMESG::u32EndMagic. (Kenazburo Oe) */
 #define DBGFOSIDMESG_MAGIC UINT32_C(0x19350131)
+
+
+/**
+ * Interface for querying Windows NT guest specifics (DBGFOSINTERFACE_WINNT).
+ */
+typedef struct DBGFOSIWINNT
+{
+    /** Trailing magic (DBGFOSIWINNT_MAGIC). */
+    uint32_t    u32Magic;
+
+    /**
+     * Queries version information.
+     *
+     * @returns VBox status code.
+     * @param   pThis                           Pointer to the interface structure.
+     * @param   pUVM                            The user mode VM handle.
+     * @param   puVersMajor                     Where to store the major version part.
+     * @param   puVersMinor                     Where to store the minor version part.
+     */
+    DECLCALLBACKMEMBER(int, pfnQueryVersion,(struct DBGFOSIWINNT *pThis, PUVM pUVM,
+                                             uint32_t *puVersMajor, uint32_t *puVersMinor));
+
+    /**
+     * Queries some base kernel pointers.
+     *
+     * @returns VBox status code.
+     * @param   pThis                           Pointer to the interface structure.
+     * @param   pUVM                            The user mode VM handle.
+     * @param   pGCPtrKernBase                  Where to store the kernel base on success.
+     * @param   pGCPtrPsLoadedModuleList        Where to store the pointer to the laoded module list head on success.
+     */
+    DECLCALLBACKMEMBER(int, pfnQueryKernelPtrs,(struct DBGFOSIWINNT *pThis, PUVM pUVM,
+                                                PRTGCUINTPTR pGCPtrKernBase, PRTGCUINTPTR pGCPtrPsLoadedModuleList));
+
+    /**
+     * Queries KPCR and KPCRB pointers for the given vCPU.
+     *
+     * @returns VBox status code.
+     * @param   pThis                           Pointer to the interface structure.
+     * @param   pUVM                            The user mode VM handle.
+     * @param   idCpu                           The vCPU to query the KPCR/KPCRB for.
+     * @param   pKpcr                           Where to store the KPCR pointer on success, optional.
+     * @param   pKpcrb                          Where to store the KPCR pointer on success, optional.
+     */
+    DECLCALLBACKMEMBER(int, pfnQueryKpcrForVCpu,(struct DBGFOSIWINNT *pThis, PUVM pUVM, VMCPUID idCpu,
+                                                 PRTGCUINTPTR pKpcr, PRTGCUINTPTR pKpcrb));
+
+    /**
+     * Queries the current thread for the given vCPU.
+     *
+     * @returns VBox status code.
+     * @param   pThis                           Pointer to the interface structure.
+     * @param   pUVM                            The user mode VM handle.
+     * @param   idCpu                           The vCPU to query the KPCR/KPCRB for.
+     * @param   pCurThrd                        Where to store the CurrentThread pointer on success.
+     */
+    DECLCALLBACKMEMBER(int, pfnQueryCurThrdForVCpu,(struct DBGFOSIWINNT *pThis, PUVM pUVM, VMCPUID idCpu,
+                                                    PRTGCUINTPTR pCurThrd));
+
+    /** Trailing magic (DBGFOSIWINNT_MAGIC). */
+    uint32_t    u32EndMagic;
+} DBGFOSIWINNT;
+/** Pointer to the interface for query kernel log messages (DBGFOSINTERFACE_WINNT). */
+typedef DBGFOSIWINNT *PDBGFOSIWINNT;
+/** Magic value for DBGFOSIWINNT::32Magic and DBGFOSIWINNT::u32EndMagic. (Dave Cutler) */
+#define DBGFOSIWINNT_MAGIC UINT32_C(0x19420313)
 
 

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

@@ -71 +71 @@
         /** DBGFOSINTERFACE_DMESG.*/
         PDBGFOSIDMESG           pDmesg;
+        /** DBGFOSINTERFACE_WINNT.*/
+        PDBGFOSIWINNT           pWinNt;
     } uDigger;
     /** The user mode VM handle. */
@@ -79 +81 @@
         /** DBGFOSINTERFACE_DMESG.*/
         DBGFOSIDMESG            Dmesg;
+        /** DBGFOSINTERFACE_WINNT.*/
+        DBGFOSIWINNT            WinNt;
     } uWrapper;
 } DBGFOSEMTWRAPPER;
@@ -528 +532 @@
                                     pWrapper->uDigger.pDmesg, pUVM, fFlags, cMessages, pszBuf, cbBuf, pcbActual);
 
+}
+
+
+/**
+ * @interface_method_impl{DBGFOSIWINNT,pfnQueryVersion, Generic EMT wrapper.}
+ */
+static DECLCALLBACK(int) dbgfR3OSEmtIWinNt_QueryVersion(PDBGFOSIWINNT pThis, PUVM pUVM, uint32_t *puVersMajor, uint32_t *puVersMinor)
+{
+    PDBGFOSEMTWRAPPER pWrapper = RT_FROM_MEMBER(pThis, DBGFOSEMTWRAPPER, uWrapper.WinNt);
+    UVM_ASSERT_VALID_EXT_RETURN(pUVM, VERR_INVALID_VM_HANDLE);
+    AssertReturn(pUVM == pWrapper->pUVM, VERR_INVALID_VM_HANDLE);
+
+    return VMR3ReqPriorityCallWaitU(pWrapper->pUVM, 0 /*idDstCpu*/,
+                                   (PFNRT)pWrapper->uDigger.pWinNt->pfnQueryVersion, 4,
+                                    pWrapper->uDigger.pWinNt, pUVM, puVersMajor, puVersMinor);
+}
+
+
+/**
+ * @interface_method_impl{DBGFOSIWINNT,pfnQueryVersion, Generic EMT wrapper.}
+ */
+static DECLCALLBACK(int) dbgfR3OSEmtIWinNt_QueryKernelPtrs(PDBGFOSIWINNT pThis, PUVM pUVM,
+                                                           PRTGCUINTPTR pGCPtrKernBase, PRTGCUINTPTR pGCPtrPsLoadedModuleList)
+{
+    PDBGFOSEMTWRAPPER pWrapper = RT_FROM_MEMBER(pThis, DBGFOSEMTWRAPPER, uWrapper.WinNt);
+    UVM_ASSERT_VALID_EXT_RETURN(pUVM, VERR_INVALID_VM_HANDLE);
+    AssertReturn(pUVM == pWrapper->pUVM, VERR_INVALID_VM_HANDLE);
+
+    return VMR3ReqPriorityCallWaitU(pWrapper->pUVM, 0 /*idDstCpu*/,
+                                   (PFNRT)pWrapper->uDigger.pWinNt->pfnQueryKernelPtrs, 4,
+                                    pWrapper->uDigger.pWinNt, pUVM, pGCPtrKernBase, pGCPtrPsLoadedModuleList);
+}
+
+
+/**
+ * @interface_method_impl{DBGFOSIWINNT,pfnQueryKpcrForVCpu, Generic EMT wrapper.}
+ */
+static DECLCALLBACK(int) dbgfR3OSEmtIWinNt_QueryKpcrForVCpu(struct DBGFOSIWINNT *pThis, PUVM pUVM, VMCPUID idCpu,
+                                                            PRTGCUINTPTR pKpcr, PRTGCUINTPTR pKpcrb)
+{
+    PDBGFOSEMTWRAPPER pWrapper = RT_FROM_MEMBER(pThis, DBGFOSEMTWRAPPER, uWrapper.WinNt);
+    UVM_ASSERT_VALID_EXT_RETURN(pUVM, VERR_INVALID_VM_HANDLE);
+    AssertReturn(pUVM == pWrapper->pUVM, VERR_INVALID_VM_HANDLE);
+
+    return VMR3ReqPriorityCallWaitU(pWrapper->pUVM, 0 /*idDstCpu*/,
+                                    (PFNRT)pWrapper->uDigger.pWinNt->pfnQueryKpcrForVCpu, 5,
+                                    pWrapper->uDigger.pWinNt, pUVM, idCpu, pKpcr, pKpcrb);
+}
+
+
+/**
+ * @interface_method_impl{DBGFOSIWINNT,pfnQueryCurThrdForVCpu, Generic EMT wrapper.}
+ */
+static DECLCALLBACK(int) dbgfR3OSEmtIWinNt_QueryCurThrdForVCpu(struct DBGFOSIWINNT *pThis, PUVM pUVM, VMCPUID idCpu,
+                                                               PRTGCUINTPTR pCurThrd)
+{
+    PDBGFOSEMTWRAPPER pWrapper = RT_FROM_MEMBER(pThis, DBGFOSEMTWRAPPER, uWrapper.WinNt);
+    UVM_ASSERT_VALID_EXT_RETURN(pUVM, VERR_INVALID_VM_HANDLE);
+    AssertReturn(pUVM == pWrapper->pUVM, VERR_INVALID_VM_HANDLE);
+
+    return VMR3ReqPriorityCallWaitU(pWrapper->pUVM, 0 /*idDstCpu*/,
+                                    (PFNRT)pWrapper->uDigger.pWinNt->pfnQueryCurThrdForVCpu, 4,
+                                    pWrapper->uDigger.pWinNt, pUVM, idCpu, pCurThrd);
 }
 
@@ -591 +658 @@
                     pWrapper->uWrapper.Dmesg.u32EndMagic       = DBGFOSIDMESG_MAGIC;
                     break;
+                case DBGFOSINTERFACE_WINNT:
+                    pWrapper->uWrapper.WinNt.u32Magic               = DBGFOSIWINNT_MAGIC;
+                    pWrapper->uWrapper.WinNt.pfnQueryVersion        = dbgfR3OSEmtIWinNt_QueryVersion;
+                    pWrapper->uWrapper.WinNt.pfnQueryKernelPtrs     = dbgfR3OSEmtIWinNt_QueryKernelPtrs;
+                    pWrapper->uWrapper.WinNt.pfnQueryKpcrForVCpu    = dbgfR3OSEmtIWinNt_QueryKpcrForVCpu;
+                    pWrapper->uWrapper.WinNt.pfnQueryCurThrdForVCpu = dbgfR3OSEmtIWinNt_QueryCurThrdForVCpu;
+                    pWrapper->uWrapper.WinNt.u32EndMagic            = DBGFOSIWINNT_MAGIC;
+                    break;
                 default:
                     AssertFailed();