Changeset 73494 in vbox for trunk/src/VBox/Runtime/include

Timestamp:

Aug 4, 2018 7:41:30 PM (6 years ago)

Author:

vboxsync

Message:

IPRT: Added single stack frame unwind function to RTDbgMod and RTLdr, copying over the PoC from DBGFRStack.cpp. bugref:3897

Location:

trunk/src/VBox/Runtime/include/internal

Files:

• dbgmod.h (modified) (2 diffs)
• ldr.h (modified) (1 diff)

trunk/src/VBox/Runtime/include/internal/dbgmod.h

@@ -243 +243 @@
     DECLCALLBACKMEMBER(int, pfnQueryProp)(PRTDBGMODINT pMod, RTLDRPROP enmProp, void *pvBuf, size_t cbBuf, size_t *pcbRet);
 
+    /**
+     * Try use unwind information to unwind one frame.
+     *
+     * @returns IPRT status code.  Last informational status from stack reader callback.
+     * @retval  VERR_DBG_NO_UNWIND_INFO if the module contains no unwind information.
+     * @retval  VERR_DBG_UNWIND_INFO_NOT_FOUND if no unwind information was found
+     *          for the location given by iSeg:off.
+     *
+     * @param   pMod        Pointer to the module structure.
+     * @param   iSeg        The segment number of the program counter.
+     * @param   off         The offset into @a iSeg.  Together with @a iSeg
+     *                      this corresponds to the RTDBGUNWINDSTATE::uPc
+     *                      value pointed to by @a pState.
+     * @param   pState      The unwind state to work.
+     *
+     * @sa      RTLdrUnwindFrame, RTDbgModUnwindFrame
+     */
+    DECLCALLBACKMEMBER(int, pfnUnwindFrame)(PRTDBGMODINT pMod, RTDBGSEGIDX iSeg, RTUINTPTR off, PRTDBGUNWINDSTATE pState);
+
     /** For catching initialization errors (RTDBGMODVTIMG_MAGIC). */
     uint32_t    u32EndMagic;
@@ -512 +531 @@
      *                      number.
      */
-    DECLCALLBACKMEMBER(int, pfnLineByAddr)(PRTDBGMODINT pMod, uint32_t iSeg, RTUINTPTR off, PRTINTPTR poffDisp, PRTDBGLINE pLineInfo);
-
+    DECLCALLBACKMEMBER(int, pfnLineByAddr)(PRTDBGMODINT pMod, uint32_t iSeg, RTUINTPTR off,
+                                           PRTINTPTR poffDisp, PRTDBGLINE pLineInfo);
+
+    /**
+     * Try use unwind information to unwind one frame.
+     *
+     * @returns IPRT status code.  Last informational status from stack reader callback.
+     * @retval  VERR_DBG_NO_UNWIND_INFO if the module contains no unwind information.
+     * @retval  VERR_DBG_UNWIND_INFO_NOT_FOUND if no unwind information was found
+     *          for the location given by iSeg:off.
+     *
+     * @param   pMod        Pointer to the module structure.
+     * @param   iSeg        The segment number of the program counter.
+     * @param   off         The offset into @a iSeg.  Together with @a iSeg
+     *                      this corresponds to the RTDBGUNWINDSTATE::uPc
+     *                      value pointed to by @a pState.
+     * @param   pState      The unwind state to work.
+     *
+     * @sa      RTDbgModUnwindFrame
+     */
+    DECLCALLBACKMEMBER(int, pfnUnwindFrame)(PRTDBGMODINT pMod, RTDBGSEGIDX iSeg, RTUINTPTR off, PRTDBGUNWINDSTATE pState);
 
     /** For catching initialization errors (RTDBGMODVTDBG_MAGIC). */

trunk/src/VBox/Runtime/include/internal/ldr.h

@@ -402 +402 @@
     DECLCALLBACKMEMBER(int, pfnHashImage)(PRTLDRMODINTERNAL pMod, RTDIGESTTYPE enmDigest, char *pszDigest, size_t cbDigest);
 
+        /**
+     * Try use unwind information to unwind one frame.
+     *
+     * @returns IPRT status code.  Last informational status from stack reader callback.
+     * @retval  VERR_DBG_NO_UNWIND_INFO if the module contains no unwind information.
+     * @retval  VERR_DBG_UNWIND_INFO_NOT_FOUND if no unwind information was found
+     *          for the location given by iSeg:off.
+     *
+     * @param   pMod        Pointer to the module structure.
+     * @param   pvBits      Pointer to the bits returned by
+     *                      RTLDROPS::pfnGetBits(), optional.
+     * @param   iSeg        The segment number of the program counter.  UINT32_MAX for RVA.
+     * @param   off         The offset into @a iSeg.  Together with @a iSeg
+     *                      this corresponds to the RTDBGUNWINDSTATE::uPc
+     *                      value pointed to by @a pState.
+     * @param   pState      The unwind state to work.
+     *
+     * @sa      RTLdrUnwindFrame, RTDbgModUnwindFrame
+     */
+    DECLCALLBACKMEMBER(int, pfnUnwindFrame)(PRTLDRMODINTERNAL pMod, void const *pvBits, uint32_t iSeg, RTUINTPTR off,
+                                            PRTDBGUNWINDSTATE pState);
+
     /** Dummy entry to make sure we've initialized it all. */
     RTUINT uDummy;