Changeset 20744 in vbox

Timestamp:

Jun 21, 2009 3:43:57 PM (15 years ago)

Author:

vboxsync

Message:

IPRT: RTDbg coding.

Location:

trunk

Files:

• include/iprt/dbg.h (modified) (8 diffs)
• include/iprt/err.h (modified) (1 diff)
• include/iprt/err.mac (modified) (1 diff)
• src/VBox/Runtime/common/dbg/dbgas.cpp (modified) (4 diffs)
• src/VBox/Runtime/common/dbg/dbgmod.cpp (modified) (4 diffs)
• src/VBox/Runtime/common/dbg/dbgmodcontainer.cpp (modified) (24 diffs)
• src/VBox/Runtime/include/internal/dbgmod.h (modified) (9 diffs)

trunk/include/iprt/dbg.h

@@ -63 +63 @@
 #define RTDBGSEGIDX_SPECIAL_FIRST   (RTDBGSEGIDX_LAST + 1U)
 
+
+/** Max length (including '\\0') of a segment name. */
+#define RTDBG_SEGMENT_NAME_LENGTH   (128 - 8 - 8 - 8 - 4 - 4)
+
+/**
+ * Debug module segment.
+ */
+typedef struct RTDBGSEGMENT
+{
+    /** The load address.
+     * RTUINTPTR_MAX if not applicable. */
+    RTUINTPTR           Address;
+    /** The image relative virtual address of the segment.
+     * RTUINTPTR_MAX if not applicable. */
+    RTUINTPTR           uRva;
+    /** The segment size. */
+    RTUINTPTR           cb;
+    /** The segment flags. (reserved) */
+    uint32_t            fFlags;
+    /** The segment index. */
+    RTDBGSEGIDX         iSeg;
+    /** Symbol name. */
+    char                szName[RTDBG_SEGMENT_NAME_LENGTH];
+} RTDBGSEGMENT;
+/** Pointer to a debug module segment. */
+typedef RTDBGSEGMENT *PRTDBGSEGMENT;
+/** Pointer to a const debug module segment. */
+typedef RTDBGSEGMENT const *PCRTDBGSEGMENT;
+
+
+
 /** Max length (including '\\0') of a symbol name. */
-#define RTDBG_SYMBOL_NAME_LENGTH   (512 - 8 - 4 - 4 - 4)
+#define RTDBG_SYMBOL_NAME_LENGTH    (384 - 8 - 8 - 8 - 4 - 4 - 8)
 
 /**
@@ -75 +106 @@
      * as RTDbgMod, but the mapping address if you ask RTDbgAs. */
     RTUINTPTR           Value;
+    /** Symbol size. */
+    RTUINTPTR           cb;
     /** Offset into the segment specified by iSeg. */
     RTUINTPTR           offSeg;
     /** Segment number. */
     RTDBGSEGIDX         iSeg;
-    /** Symbol size. */
-    uint32_t            cb;
     /** Symbol Flags. (reserved). */
     uint32_t            fFlags;
+    /** Symbol ordinal.
+     * This is set to UINT32_MAX if the ordinals aren't supported. */
+    uint32_t            iOrdinal;
     /** Symbol name. */
     char                szName[RTDBG_SYMBOL_NAME_LENGTH];
@@ -116 +150 @@
 
 /** Max length (including '\\0') of a debug info file name. */
-#define RTDBG_FILE_NAME_LENGTH   (260)
+#define RTDBG_FILE_NAME_LENGTH      (260)
 
 
@@ -134 +168 @@
     /** Line number. */
     uint32_t            uLineNo;
+    /** Symbol ordinal.
+     * This is set to UINT32_MAX if the ordinals aren't supported. */
+    uint32_t            iOrdinal;
     /** Filename. */
     char                szFilename[RTDBG_FILE_NAME_LENGTH];
@@ -418 +455 @@
  * @param   cb              The size of the symbol.
  * @param   fFlags          Symbol flags.
- */
-RTDECL(int) RTDbgAsSymbolAdd(RTDBGAS hDbgAs, const char *pszSymbol, RTUINTPTR Addr, RTUINTPTR cb, uint32_t fFlags);
+ * @param   piOrdinal       Where to return the symbol ordinal on success. If
+ *                          the interpreter doesn't do ordinals, this will be set to
+ *                          UINT32_MAX. Optional
+ */
+RTDECL(int) RTDbgAsSymbolAdd(RTDBGAS hDbgAs, const char *pszSymbol, RTUINTPTR Addr, RTUINTPTR cb, uint32_t fFlags, uint32_t *piOrdinal);
 
 /**
@@ -491 +531 @@
  */
 RTDECL(int) RTDbgAs(RTDBGAS hDbgAs, RTUINTPTR Addr, PRTINTPTR poffDisp, PRTDBGLINE pLine);
+
+/**
+ * Adds a line number to a module in the address space.
+ *
+ * @returns IPRT status code. See RTDbgModSymbolAdd for more specific ones.
+ * @retval  VERR_INVALID_HANDLE if hDbgAs is invalid.
+ * @retval  VERR_NOT_FOUND if no module was found at the specified address.
+ * @retval  VERR_NOT_SUPPORTED if the module interpret doesn't support adding
+ *          custom symbols.
+ *
+ * @param   hDbgAs          The address space handle.
+ * @param   pszFile         The file name.
+ * @param   uLineNo         The line number.
+ * @param   Addr            The address of the symbol.
+ * @param   piOrdinal       Where to return the line number ordinal on success.
+ *                          If the interpreter doesn't do ordinals, this will be
+ *                          set to UINT32_MAX. Optional.
+ */
+RTDECL(int) RTDbgAsLineAdd(RTDBGAS hDbgAs, const char *pszFile, uint32_t uLineNo, RTUINTPTR Addr, uint32_t *piOrdinal);
 
 /**
@@ -524 +583 @@
 RTDECL(const char *) RTDbgModName(RTDBGMOD hDbgMod);
 RTDECL(RTUINTPTR)   RTDbgModImageSize(RTDBGMOD hDbgMod);
+
+RTDECL(int)         RTDbgModSegmentAdd(RTDBGMOD hDbgMod, RTUINTPTR uRva, RTUINTPTR cb, const char *pszName, size_t cchName, uint32_t fFlags, PRTDBGSEGIDX piSeg);
+RTDECL(RTDBGSEGIDX) RTDbgModSegmentCount(RTDBGMOD hDbgMod);
+RTDECL(int)         RTDbgModSegmentByIndex(RTDBGMOD hDbgMod, RTDBGSEGIDX iSeg, PRTDBGSEGMENT pSegInfo);
 RTDECL(RTUINTPTR)   RTDbgModSegmentSize(RTDBGMOD hDbgMod, RTDBGSEGIDX iSeg);
 RTDECL(RTUINTPTR)   RTDbgModSegmentRva(RTDBGMOD hDbgMod, RTDBGSEGIDX iSeg);
-RTDECL(RTDBGSEGIDX) RTDbgModSegmentCount(RTDBGMOD hDbgMod);
-
-RTDECL(int)         RTDbgModSymbolAdd(RTDBGMOD hDbgMod, const char *pszSymbol, RTDBGSEGIDX iSeg, RTUINTPTR off, RTUINTPTR cb, uint32_t fFlags);
+
+RTDECL(int)         RTDbgModSymbolAdd(RTDBGMOD hDbgMod, const char *pszSymbol, RTDBGSEGIDX iSeg, RTUINTPTR off, RTUINTPTR cb, uint32_t fFlags, uint32_t *piOrdinal);
 RTDECL(uint32_t)    RTDbgModSymbolCount(RTDBGMOD hDbgMod);
 RTDECL(int)         RTDbgModSymbolByIndex(RTDBGMOD hDbgMod, uint32_t iSymbol, PRTDBGSYMBOL pSymbol);
@@ -536 +598 @@
 RTDECL(int)         RTDbgModSymbolByNameA(RTDBGMOD hDbgMod, const char *pszSymbol, PRTDBGSYMBOL *ppSymbol);
 
-RTDECL(int)         RTDbgModLineAdd(RTDBGMOD hDbgMod, const char *pszFile, uint32_t uLineNo, RTDBGSEGIDX iSeg, RTUINTPTR off);
+RTDECL(int)         RTDbgModLineAdd(RTDBGMOD hDbgMod, const char *pszFile, uint32_t uLineNo, RTDBGSEGIDX iSeg, RTUINTPTR off, uint32_t *piOrdinal);
 RTDECL(int)         RTDbgModLineByAddr(RTDBGMOD hDbgMod, RTDBGSEGIDX iSeg, RTUINTPTR off, PRTINTPTR poffDisp, PRTDBGLINE pLine);
 RTDECL(int)         RTDbgModLineByAddrA(RTDBGMOD hDbgMod, RTDBGSEGIDX iSeg, RTUINTPTR off, PRTINTPTR poffDisp, PRTDBGLINE *ppLine);

trunk/include/iprt/err.h

@@ -939 +939 @@
  * @{
  */
+/** The module contains no line number information. */
+#define VERR_DBG_NO_LINE_NUMBERS                (-650)
+/** The module contains no symbol information. */
+#define VERR_DBG_NO_SYMBOLS                     (-651)
 /** The specified segment:offset address was invalid. Typically an attempt at
  * addressing outside the segment boundrary. */
-#define VERR_DBG_INVALID_ADDRESS                (-650)
+#define VERR_DBG_INVALID_ADDRESS                (-652)
 /** Invalid segment index. */
-#define VERR_DBG_INVALID_SEGMENT_INDEX          (-651)
+#define VERR_DBG_INVALID_SEGMENT_INDEX          (-653)
 /** Invalid segment offset. */
-#define VERR_DBG_INVALID_SEGMENT_OFFSET         (-652)
+#define VERR_DBG_INVALID_SEGMENT_OFFSET         (-654)
 /** Invalid image relative virtual address. */
-#define VERR_DBG_INVALID_RVA                    (-653)
-/** The module contains no line number information. */
-#define VERR_DBG_NO_LINE_NUMBERS                (-654)
+#define VERR_DBG_INVALID_RVA                    (-655)
 /** Address conflict within a module/segment.
  * Attempted to add a symbol or line number that fully or partially overlaps with an existing one.  */
-#define VERR_DBG_ADDRESS_CONFLICT               (-655)
+#define VERR_DBG_ADDRESS_CONFLICT               (-656)
 /** Duplicate symbol within the module.
  * Attempted to add a symbol which name already exists within the module.  */
-#define VERR_DBG_DUPLICATE_SYMBOL               (-656)
+#define VERR_DBG_DUPLICATE_SYMBOL               (-657)
+/** The segment index specified when adding a new segment is already in use. */
+#define VERR_DBG_SEGMENT_INDEX_CONFLICT         (-658)
+/** No line number was found for the specified address/ordinal/whatever. */
+#define VERR_DBG_LINE_NOT_FOUND                 (-659)
 /** The length of the symbol name is out of range.
  * This means it is an empty string or that it's greater or equal to
  * RTDBG_SYMBOL_NAME_LENGTH. */
-#define VERR_DBG_SYMBOL_NAME_OUT_OF_RANGE       (-657)
+#define VERR_DBG_SYMBOL_NAME_OUT_OF_RANGE       (-660)
 /** The length of the file name is out of range.
  * This means it is an empty string or that it's greater or equal to
  * RTDBG_FILE_NAME_LENGTH. */
-#define VERR_DBG_FILE_NAME_OUT_OF_RANGE         (-658)
+#define VERR_DBG_FILE_NAME_OUT_OF_RANGE         (-661)
 /** @} */
 

trunk/include/iprt/err.mac

@@ -274 +274 @@
 %define VERR_LDRELF_INVALID_RELOCATION_OFFSET    (-639)
 %define VERR_LDRELF_NO_SYMBOL_OR_NO_STRING_TABS    (-640)
-%define VERR_DBGMOD_INVALID_ADDRESS    (-650)
+%define VERR_DBG_NO_LINE_NUMBERS    (-650)
+%define VERR_DBG_NO_SYMBOLS    (-651)
+%define VERR_DBG_INVALID_ADDRESS    (-652)
+%define VERR_DBG_INVALID_SEGMENT_INDEX    (-653)
+%define VERR_DBG_INVALID_SEGMENT_OFFSET    (-654)
+%define VERR_DBG_INVALID_RVA    (-655)
+%define VERR_DBG_ADDRESS_CONFLICT    (-656)
+%define VERR_DBG_DUPLICATE_SYMBOL    (-657)
+%define VERR_DBG_SEGMENT_INDEX_CONFLICT    (-658)
+%define VERR_DBG_LINE_NOT_FOUND    (-659)
+%define VERR_DBG_SYMBOL_NAME_OUT_OF_RANGE    (-660)
+%define VERR_DBG_FILE_NAME_OUT_OF_RANGE    (-661)
 %define VERR_RT_REQUEST_INVALID_TYPE    (-700)
 %define VERR_RT_REQUEST_STATE    (-701)

trunk/src/VBox/Runtime/common/dbg/dbgas.cpp

@@ -1148 +1148 @@
  * @param   fFlags          Symbol flags.
  */
-RTDECL(int) RTDbgAsSymbolAdd(RTDBGAS hDbgAs, const char *pszSymbol, RTUINTPTR Addr, RTUINTPTR cb, uint32_t fFlags)
+RTDECL(int) RTDbgAsSymbolAdd(RTDBGAS hDbgAs, const char *pszSymbol, RTUINTPTR Addr, RTUINTPTR cb, uint32_t fFlags, uint32_t *piOrdinal)
 {
     /*
@@ -1165 +1165 @@
      * Forward the call.
      */
-    int rc = RTDbgModSymbolAdd(hMod, pszSymbol, iSeg, offSeg, cb, fFlags);
+    int rc = RTDbgModSymbolAdd(hMod, pszSymbol, iSeg, offSeg, cb, fFlags, piOrdinal);
     RTDbgModRelease(hMod);
     return rc;
@@ -1464 +1464 @@
  * @param   uLineNo         The line number.
  * @param   Addr            The address of the symbol.
- */
-RTDECL(int) RTDbgAsLineAdd(RTDBGAS hDbgAs, const char *pszFile, uint32_t uLineNo, RTUINTPTR Addr)
+ * @param   piOrdinal       Where to return the line number ordinal on success.
+ *                          If the interpreter doesn't do ordinals, this will be
+ *                          set to UINT32_MAX. Optional.
+ */
+RTDECL(int) RTDbgAsLineAdd(RTDBGAS hDbgAs, const char *pszFile, uint32_t uLineNo, RTUINTPTR Addr, uint32_t *piOrdinal)
 {
     /*
@@ -1482 +1485 @@
      * Forward the call.
      */
-    int rc = RTDbgModLineAdd(hMod, pszFile, uLineNo, iSeg, offSeg);
+    int rc = RTDbgModLineAdd(hMod, pszFile, uLineNo, iSeg, offSeg, piOrdinal);
     RTDbgModRelease(hMod);
     return rc;

trunk/src/VBox/Runtime/common/dbg/dbgmod.cpp

@@ -405 +405 @@
  * @param   cb              The size of the symbol.
  * @param   fFlags          Symbol flags.
- */
-RTDECL(int) RTDbgModSymbolAdd(RTDBGMOD hDbgMod, const char *pszSymbol, RTDBGSEGIDX iSeg, RTUINTPTR off, RTUINTPTR cb, uint32_t fFlags)
+ * @param   piOrdinal       Where to return the symbol ordinal on success. If
+ *                          the interpreter doesn't do ordinals, this will be set to
+ *                          UINT32_MAX. Optional
+ */
+RTDECL(int) RTDbgModSymbolAdd(RTDBGMOD hDbgMod, const char *pszSymbol, RTDBGSEGIDX iSeg, RTUINTPTR off, RTUINTPTR cb, uint32_t fFlags, uint32_t *piOrdinal)
 {
     /*
@@ -442 +445 @@
      * Get down to business.
      */
-    int rc = pDbgMod->pDbgVt->pfnSymbolAdd(pDbgMod, pszSymbol, cchSymbol, iSeg, off, cb, fFlags);
+    int rc = pDbgMod->pDbgVt->pfnSymbolAdd(pDbgMod, pszSymbol, cchSymbol, iSeg, off, cb, fFlags, piOrdinal);
 
     RTDBGMOD_UNLOCK(pDbgMod);
@@ -498 +501 @@
  * @param   iSeg            The segment index.
  * @param   off             The segment offset.
- */
-RTDECL(int) RTDbgModLineAdd(RTDBGMOD hDbgMod, const char *pszFile, uint32_t uLineNo, RTDBGSEGIDX iSeg, RTUINTPTR off)
+ * @param   piOrdinal       Where to return the line number ordinal on success.
+ *                          If the interpreter doesn't do ordinals, this will be
+ *                          set to UINT32_MAX. Optional.
+ */
+RTDECL(int) RTDbgModLineAdd(RTDBGMOD hDbgMod, const char *pszFile, uint32_t uLineNo, RTDBGSEGIDX iSeg, RTUINTPTR off, uint32_t *piOrdinal)
 {
     /*
@@ -534 +540 @@
      * Get down to business.
      */
-    int rc = pDbgMod->pDbgVt->pfnLineAdd(pDbgMod, pszFile, cchFile, uLineNo, iSeg, off);
+    int rc = pDbgMod->pDbgVt->pfnLineAdd(pDbgMod, pszFile, cchFile, uLineNo, iSeg, off, piOrdinal);
 
     RTDBGMOD_UNLOCK(pDbgMod);

trunk/src/VBox/Runtime/common/dbg/dbgmodcontainer.cpp

@@ -19 +19 @@
  * Symbol entry.
  */
-typedef struct RTDBGMODCONTAINERSYMBOL
+typedef struct RTDBGMODCTNSYMBOL
 {
     /** The address core. */
@@ -25 +25 @@
     /** The name space core. */
     RTSTRSPACECORE              NameCore;
+    /** The ordinal number core. */
+    AVLU32NODECORE              OrdinalCore;
     /** The segment index. */
     RTDBGSEGIDX                 iSeg;
@@ -32 +34 @@
      * This may be zero while the range in AddrCore indicates 0. */
     RTUINTPTR                   cb;
-} RTDBGMODCONTAINERSYMBOL;
+} RTDBGMODCTNSYMBOL;
 /** Pointer to a symbol entry in the debug info container. */
-typedef RTDBGMODCONTAINERSYMBOL *PRTDBGMODCONTAINERSYMBOL;
+typedef RTDBGMODCTNSYMBOL *PRTDBGMODCTNSYMBOL;
 /** Pointer to a const symbol entry in the debug info container. */
-typedef RTDBGMODCONTAINERSYMBOL const *PCRTDBGMODCONTAINERSYMBOL;
+typedef RTDBGMODCTNSYMBOL const *PCRTDBGMODCTNSYMBOL;
 
 /**
  * Line number entry.
  */
-typedef struct RTDBGMODCONTAINERLINE
+typedef struct RTDBGMODCTNLINE
 {
     /** The address core.
      * The Key is the address of the line number. */
-    AVLUINTPTRNODECORE  AddrCore;
+    AVLUINTPTRNODECORE          AddrCore;
+    /** The ordinal number core. */
+    AVLU32NODECORE              OrdinalCore;
     /** Pointer to the file name (in string cache). */
-    const char         *pszFile;
+    const char                 *pszFile;
     /** The line number. */
-    uint32_t            uLineNo;
-} RTDBGMODCONTAINERLINE;
+    uint32_t                    uLineNo;
+    /** The segment index. */
+    RTDBGSEGIDX                 iSeg;
+} RTDBGMODCTNLINE;
 /** Pointer to a line number entry. */
-typedef RTDBGMODCONTAINERLINE *PRTDBGMODCONTAINERLINE;
+typedef RTDBGMODCTNLINE *PRTDBGMODCTNLINE;
 /** Pointer to const a line number entry. */
-typedef RTDBGMODCONTAINERLINE const *PCRTDBGMODCONTAINERLINE;
+typedef RTDBGMODCTNLINE const *PCRTDBGMODCTNLINE;
 
 /**
  * Segment entry.
  */
-typedef struct RTDBGMODCONTAINERSEGMENT
+typedef struct RTDBGMODCTNSEGMENT
 {
     /** The symbol address space tree. */
@@ -71 +77 @@
     /** The segment name. */
     const char                 *pszName;
-} RTDBGMODCONTAINERSEGMENT;
+} RTDBGMODCTNSEGMENT;
 /** Pointer to a segment entry in the debug info container. */
-typedef RTDBGMODCONTAINERSEGMENT *PRTDBGMODCONTAINERSEGMENT;
+typedef RTDBGMODCTNSEGMENT *PRTDBGMODCTNSEGMENT;
 /** Pointer to a const segment entry in the debug info container. */
-typedef RTDBGMODCONTAINERSEGMENT const *PCRTDBGMODCONTAINERSEGMENT;
+typedef RTDBGMODCTNSEGMENT const *PCRTDBGMODCTNSEGMENT;
 
 /**
  * Instance data.
  */
-typedef struct RTDBGMODCONTAINER
+typedef struct RTDBGMODCTN
 {
     /** The name space. */
@@ -86 +92 @@
     /** Tree containing any absolute addresses. */
     AVLRUINTPTRTREE             AbsAddrTree;
+    /** Tree organizing the symbols by ordinal number. */
+    AVLU32TREE                  SymbolOrdinalTree;
+     /** Tree organizing the line numbers by ordinal number. */
+    AVLU32TREE                  LineOrdinalTree;
     /** Segment table. */
-    PRTDBGMODCONTAINERSEGMENT   paSegs;
+    PRTDBGMODCTNSEGMENT         paSegs;
     /** The number of segments in the segment table. */
     RTDBGSEGIDX                 cSegs;
     /** The image size. 0 means unlimited. */
     RTUINTPTR                   cb;
-} RTDBGMODCONTAINER;
+    /** The next symbol ordinal. */
+    uint32_t                    iNextSymbolOrdinal;
+    /** The next line number ordinal. */
+    uint32_t                    iNextLineOrdinal;
+} RTDBGMODCTN;
 /** Pointer to instance data for the debug info container. */
-typedef RTDBGMODCONTAINER *PRTDBGMODCONTAINER;
+typedef RTDBGMODCTN *PRTDBGMODCTN;
 
 
@@ -104 +118 @@
  * @param   pExtSym         The external symbol representation.
  */
-DECLINLINE(int) rtDbgModContainerReturnSymbol(PCRTDBGMODCONTAINERSYMBOL pMySym, PRTDBGSYMBOL pExtSym)
-{
-    pExtSym->Value  = pMySym->AddrCore.Key;
-    pExtSym->offSeg = pMySym->AddrCore.Key;
-    pExtSym->iSeg   = pMySym->iSeg;
-    pExtSym->fFlags = pMySym->fFlags;
-    pExtSym->cb     = pMySym->cb;
+DECLINLINE(int) rtDbgModContainerReturnSymbol(PCRTDBGMODCTNSYMBOL pMySym, PRTDBGSYMBOL pExtSym)
+{
+    pExtSym->Value    = pMySym->AddrCore.Key;
+    pExtSym->offSeg   = pMySym->AddrCore.Key;
+    pExtSym->iSeg     = pMySym->iSeg;
+    pExtSym->fFlags   = pMySym->fFlags;
+    pExtSym->cb       = pMySym->cb;
+    pExtSym->iOrdinal = pMySym->OrdinalCore.Key;
     Assert(pMySym->NameCore.cchString < sizeof(pExtSym->szName));
     memcpy(pExtSym->szName, pMySym->NameCore.pszString, pMySym->NameCore.cchString + 1);
@@ -122 +137 @@
                                                       PRTINTPTR poffDisp, PRTDBGLINE pLine)
 {
-    PRTDBGMODCONTAINER pThis = (PRTDBGMODCONTAINER)pMod->pvDbgPriv;
+    PRTDBGMODCTN pThis = (PRTDBGMODCTN)pMod->pvDbgPriv;
 
     /*
@@ -139 +154 @@
     PAVLUINTPTRNODECORE pAvlCore = RTAvlUIntPtrGetBestFit(&pThis->paSegs[iSeg].LineAddrTree, off, false /*fAbove*/);
     if (!pAvlCore)
-        return VERR_SYMBOL_NOT_FOUND;
-    PCRTDBGMODCONTAINERLINE pMyLine = RT_FROM_MEMBER(pAvlCore, RTDBGMODCONTAINERLINE const, AddrCore);
-    if (poffDisp)
-        *poffDisp = off - pMyLine->AddrCore.Key;
+        return pThis->iNextLineOrdinal
+             ? VERR_DBG_LINE_NOT_FOUND
+             : VERR_DBG_NO_LINE_NUMBERS;
+    PCRTDBGMODCTNLINE pMyLine = RT_FROM_MEMBER(pAvlCore, RTDBGMODCTNLINE const, AddrCore);
     pLine->Address = pMyLine->AddrCore.Key;
     pLine->offSeg  = pMyLine->AddrCore.Key;
     pLine->iSeg    = iSeg;
     pLine->uLineNo = pMyLine->uLineNo;
+    pLine->iOrdinal = pMyLine->OrdinalCore.Key;
+    strcpy(pLine->szFilename, pMyLine->pszFile);
+    if (poffDisp)
+        *poffDisp = off - pMyLine->AddrCore.Key;
+    return VINF_SUCCESS;
+}
+
+
+/** @copydoc RTDBGMODVTDBG::pfnLineByOrdinal */
+static DECLCALLBACK(int) rtDbgModContainer_LineByOrdinal(PRTDBGMODINT pMod, uint32_t iOrdinal, PRTDBGLINE pLine)
+{
+    PRTDBGMODCTN pThis = (PRTDBGMODCTN)pMod->pvDbgPriv;
+
+    /*
+     * Look it up.
+     */
+    if (iOrdinal >= pThis->iNextLineOrdinal)
+        return pThis->iNextLineOrdinal
+             ? VERR_DBG_LINE_NOT_FOUND
+             : VERR_DBG_NO_LINE_NUMBERS;
+    PAVLU32NODECORE pAvlCore = RTAvlU32Get(&pThis->LineOrdinalTree, iOrdinal);
+    AssertReturn(pAvlCore, VERR_DBG_LINE_NOT_FOUND);
+    PCRTDBGMODCTNLINE pMyLine = RT_FROM_MEMBER(pAvlCore, RTDBGMODCTNLINE const, OrdinalCore);
+    pLine->Address  = pMyLine->AddrCore.Key;
+    pLine->offSeg   = pMyLine->AddrCore.Key;
+    pLine->iSeg     = pMyLine->iSeg;
+    pLine->uLineNo  = pMyLine->uLineNo;
+    pLine->iOrdinal = pMyLine->OrdinalCore.Key;
     strcpy(pLine->szFilename, pMyLine->pszFile);
     return VINF_SUCCESS;
@@ -152 +195 @@
 
 
+/** @copydoc RTDBGMODVTDBG::pfnLineCount */
+static DECLCALLBACK(uint32_t) rtDbgModContainer_LineCount(PRTDBGMODINT pMod)
+{
+    PRTDBGMODCTN pThis = (PRTDBGMODCTN)pMod->pvDbgPriv;
+
+    /* Note! The ordinal numbers are 0-based. */
+    return pThis->iNextLineOrdinal;
+}
+
+
 /** @copydoc RTDBGMODVTDBG::pfnLineAdd */
 static DECLCALLBACK(int) rtDbgModContainer_LineAdd(PRTDBGMODINT pMod, const char *pszFile, size_t cchFile, uint32_t uLineNo,
-                                                   uint32_t iSeg, RTUINTPTR off)
-{
-    PRTDBGMODCONTAINER pThis = (PRTDBGMODCONTAINER)pMod->pvDbgPriv;
+                                                   uint32_t iSeg, RTUINTPTR off, uint32_t *piOrdinal)
+{
+    PRTDBGMODCTN pThis = (PRTDBGMODCTN)pMod->pvDbgPriv;
 
     /*
@@ -169 +222 @@
      * Create a new entry.
      */
-    PRTDBGMODCONTAINERLINE pLine = (PRTDBGMODCONTAINERLINE)RTMemAllocZ(sizeof(*pLine));
+    PRTDBGMODCTNLINE pLine = (PRTDBGMODCTNLINE)RTMemAllocZ(sizeof(*pLine));
     if (!pLine)
         return VERR_NO_MEMORY;
-    pLine->AddrCore.Key = off;
-    pLine->uLineNo = uLineNo;
-    pLine->pszFile = RTStrCacheEnterN(g_hDbgModStrCache, pszFile, cchFile);
+    pLine->AddrCore.Key     = off;
+    pLine->OrdinalCore.Key  = pThis->iNextLineOrdinal;
+    pLine->uLineNo          = uLineNo;
+    pLine->iSeg             = iSeg;
+    pLine->pszFile          = RTStrCacheEnterN(g_hDbgModStrCache, pszFile, cchFile);
     int rc;
     if (pLine->pszFile)
     {
         if (RTAvlUIntPtrInsert(&pThis->paSegs[iSeg].LineAddrTree, &pLine->AddrCore))
-            return VINF_SUCCESS;
+        {
+            if (RTAvlU32Insert(&pThis->LineOrdinalTree, &pLine->OrdinalCore))
+            {
+                if (piOrdinal)
+                    *piOrdinal = pThis->iNextLineOrdinal;
+                pThis->iNextLineOrdinal++;
+                return VINF_SUCCESS;
+            }
+
+            rc = VERR_INTERNAL_ERROR_5;
+            RTAvlUIntPtrRemove(&pThis->paSegs[iSeg].LineAddrTree, pLine->AddrCore.Key);
+        }
 
         /* bail out */
@@ -196 +262 @@
                                                         PRTINTPTR poffDisp, PRTDBGSYMBOL pSymbol)
 {
-    PRTDBGMODCONTAINER pThis = (PRTDBGMODCONTAINER)pMod->pvDbgPriv;
+    PRTDBGMODCTN pThis = (PRTDBGMODCTN)pMod->pvDbgPriv;
 
     /*
@@ -220 +286 @@
     if (!pAvlCore)
         return VERR_SYMBOL_NOT_FOUND;
-    PCRTDBGMODCONTAINERSYMBOL pMySym = RT_FROM_MEMBER(pAvlCore, RTDBGMODCONTAINERSYMBOL const, AddrCore);
+    PCRTDBGMODCTNSYMBOL pMySym = RT_FROM_MEMBER(pAvlCore, RTDBGMODCTNSYMBOL const, AddrCore);
     if (poffDisp)
         *poffDisp = off - pMySym->AddrCore.Key;
@@ -230 +296 @@
 static DECLCALLBACK(int) rtDbgModContainer_SymbolByName(PRTDBGMODINT pMod, const char *pszSymbol, PRTDBGSYMBOL pSymbol)
 {
-    PRTDBGMODCONTAINER pThis = (PRTDBGMODCONTAINER)pMod->pvDbgPriv;
+    PRTDBGMODCTN pThis = (PRTDBGMODCTN)pMod->pvDbgPriv;
 
     /*
@@ -238 +304 @@
     if (!pStrCore)
         return VERR_SYMBOL_NOT_FOUND;
-    PCRTDBGMODCONTAINERSYMBOL pMySym = RT_FROM_MEMBER(pStrCore, RTDBGMODCONTAINERSYMBOL const, NameCore);
+    PCRTDBGMODCTNSYMBOL pMySym = RT_FROM_MEMBER(pStrCore, RTDBGMODCTNSYMBOL const, NameCore);
     return rtDbgModContainerReturnSymbol(pMySym, pSymbol);
+}
+
+
+/** @copydoc RTDBGMODVTDBG::pfnSymbolByOrdinal */
+static DECLCALLBACK(int) rtDbgModContainer_SymbolByOrdinal(PRTDBGMODINT pMod, uint32_t iOrdinal, PRTDBGSYMBOL pSymbol)
+{
+    PRTDBGMODCTN pThis = (PRTDBGMODCTN)pMod->pvDbgPriv;
+
+    /*
+     * Look it up in the ordinal tree.
+     */
+    if (iOrdinal >= pThis->iNextSymbolOrdinal)
+        return pThis->iNextSymbolOrdinal
+             ? VERR_DBG_NO_SYMBOLS
+             : VERR_SYMBOL_NOT_FOUND;
+    PAVLU32NODECORE pAvlCore = RTAvlU32Get(&pThis->SymbolOrdinalTree, iOrdinal);
+    AssertReturn(pAvlCore, VERR_SYMBOL_NOT_FOUND);
+    PCRTDBGMODCTNSYMBOL pMySym = RT_FROM_MEMBER(pAvlCore, RTDBGMODCTNSYMBOL const, OrdinalCore);
+    return rtDbgModContainerReturnSymbol(pMySym, pSymbol);
+}
+
+
+/** @copydoc RTDBGMODVTDBG::pfnSymbolCount */
+static DECLCALLBACK(uint32_t) rtDbgModContainer_SymbolCount(PRTDBGMODINT pMod)
+{
+    PRTDBGMODCTN pThis = (PRTDBGMODCTN)pMod->pvDbgPriv;
+
+    /* Note! The ordinal numbers are 0-based. */
+    return pThis->iNextSymbolOrdinal;
 }
 
@@ -245 +340 @@
 /** @copydoc RTDBGMODVTDBG::pfnSymbolAdd */
 static DECLCALLBACK(int) rtDbgModContainer_SymbolAdd(PRTDBGMODINT pMod, const char *pszSymbol, size_t cchSymbol,
-                                                     RTDBGSEGIDX iSeg, RTUINTPTR off, RTUINTPTR cb, uint32_t fFlags)
-{
-    PRTDBGMODCONTAINER pThis = (PRTDBGMODCONTAINER)pMod->pvDbgPriv;
+                                                     RTDBGSEGIDX iSeg, RTUINTPTR off, RTUINTPTR cb, uint32_t fFlags,
+                                                     uint32_t *piOrdinal)
+{
+    PRTDBGMODCTN pThis = (PRTDBGMODCTN)pMod->pvDbgPriv;
 
     /*
@@ -264 +360 @@
      * Create a new entry.
      */
-    PRTDBGMODCONTAINERSYMBOL pSymbol = (PRTDBGMODCONTAINERSYMBOL)RTMemAllocZ(sizeof(*pSymbol));
+    PRTDBGMODCTNSYMBOL pSymbol = (PRTDBGMODCTNSYMBOL)RTMemAllocZ(sizeof(*pSymbol));
     if (!pSymbol)
         return VERR_NO_MEMORY;
@@ -270 +366 @@
     pSymbol->AddrCore.Key       = off;
     pSymbol->AddrCore.KeyLast   = off + RT_MIN(cb, 1);
+    pSymbol->OrdinalCore.Key    = pThis->iNextSymbolOrdinal;
     pSymbol->iSeg               = iSeg;
     pSymbol->cb                 = cb;
@@ -279 +376 @@
         if (RTStrSpaceInsert(&pThis->Names, &pSymbol->NameCore))
         {
-            if (RTAvlrUIntPtrInsert(  iSeg == RTDBGSEGIDX_ABS
-                                    ? &pThis->AbsAddrTree
-                                    : &pThis->paSegs[iSeg].SymAddrTree,
-                                    &pSymbol->AddrCore))
-                return VINF_SUCCESS;
-
-            /* bail out */
-            rc = VERR_DBG_ADDRESS_CONFLICT;
+            PAVLRUINTPTRTREE pAddrTree = iSeg == RTDBGSEGIDX_ABS
+                                       ? &pThis->AbsAddrTree
+                                       : &pThis->paSegs[iSeg].SymAddrTree;
+            if (RTAvlrUIntPtrInsert(pAddrTree, &pSymbol->AddrCore))
+            {
+                if (RTAvlU32Insert(&pThis->LineOrdinalTree, &pSymbol->OrdinalCore))
+                {
+                    if (piOrdinal)
+                        *piOrdinal = pThis->iNextSymbolOrdinal;
+                    pThis->iNextSymbolOrdinal++;
+                    return VINF_SUCCESS;
+                }
+
+                /* bail out */
+                rc = VERR_INTERNAL_ERROR_5;
+                RTAvlrUIntPtrRemove(pAddrTree, pSymbol->AddrCore.Key);
+            }
+            else
+                rc = VERR_DBG_ADDRESS_CONFLICT;
             RTStrSpaceRemove(&pThis->Names, pSymbol->NameCore.pszString);
         }
@@ -303 +411 @@
 static DECLCALLBACK(RTDBGSEGIDX) rtDbgModContainer_RvaToSegOff(PRTDBGMODINT pMod, RTUINTPTR uRva, PRTUINTPTR poffSeg)
 {
-    PRTDBGMODCONTAINER          pThis = (PRTDBGMODCONTAINER)pMod->pvDbgPriv;
-    PCRTDBGMODCONTAINERSEGMENT  paSeg = pThis->paSegs;
+    PRTDBGMODCTN          pThis = (PRTDBGMODCTN)pMod->pvDbgPriv;
+    PCRTDBGMODCTNSEGMENT  paSeg = pThis->paSegs;
     uint32_t const              cSegs = pThis->cSegs;
     if (cSegs <= 7)
@@ -366 +474 @@
 static DECLCALLBACK(int)  rtDbgModContainer_DestroyTreeNode(PAVLRUINTPTRNODECORE pNode, void *pvUser)
 {
-    PRTDBGMODCONTAINERSYMBOL pSym = RT_FROM_MEMBER(pNode, RTDBGMODCONTAINERSYMBOL, AddrCore);
+    PRTDBGMODCTNSYMBOL pSym = RT_FROM_MEMBER(pNode, RTDBGMODCTNSYMBOL, AddrCore);
     RTStrCacheRelease(g_hDbgModStrCache, pSym->NameCore.pszString);
     pSym->NameCore.pszString = NULL;
@@ -377 +485 @@
 static DECLCALLBACK(int) rtDbgModContainer_Close(PRTDBGMODINT pMod)
 {
-    PRTDBGMODCONTAINER pThis = (PRTDBGMODCONTAINER)pMod->pvDbgPriv;
+    PRTDBGMODCTN pThis = (PRTDBGMODCTN)pMod->pvDbgPriv;
 
     /*
@@ -416 +524 @@
     /*.pfnClose = */            rtDbgModContainer_Close,
     /*.pfnRvaToSegOff = */      rtDbgModContainer_RvaToSegOff,
+
+    /*.pfnSegmentAdd = */       NULL,//rtDbgModContainer_SegmentAdd,
+    /*.pfnSegmentCount = */     NULL,//rtDbgModContainer_SegmentCount,
+    /*.pfnSegmentByIndex = */   NULL,//rtDbgModContainer_SegmentByIndex,
+
     /*.pfnSymbolAdd = */        rtDbgModContainer_SymbolAdd,
+    /*.pfnSymbolCount = */      rtDbgModContainer_SymbolCount,
+    /*.pfnSymbolByOrdinal = */  rtDbgModContainer_SymbolByOrdinal,
     /*.pfnSymbolByName = */     rtDbgModContainer_SymbolByName,
     /*.pfnSymbolByAddr = */     rtDbgModContainer_SymbolByAddr,
+
     /*.pfnLineAdd = */          rtDbgModContainer_LineAdd,
+    /*.pfnLineCount = */        rtDbgModContainer_LineCount,
+    /*.pfnLineByOrdinal = */    rtDbgModContainer_LineByOrdinal,
     /*.pfnLineByAddr = */       rtDbgModContainer_LineByAddr,
+
     /*.u32EndMagic = */         RTDBGMODVTDBG_MAGIC
 };
@@ -435 +554 @@
 int rtDbgModContainerCreate(PRTDBGMODINT pMod, RTUINTPTR cb)
 {
-    PRTDBGMODCONTAINER pThis = (PRTDBGMODCONTAINER)RTMemAlloc(sizeof(*pThis));
+    PRTDBGMODCTN pThis = (PRTDBGMODCTN)RTMemAlloc(sizeof(*pThis));
     if (!pThis)
         return VERR_NO_MEMORY;
@@ -441 +560 @@
     pThis->Names = NULL;
     pThis->AbsAddrTree = NULL;
+    pThis->SymbolOrdinalTree = NULL;
+    pThis->LineOrdinalTree = NULL;
     pThis->paSegs = NULL;
     pThis->cSegs = 0;
-    pThis->cb = cb;
+    pThis->cb = cb; /** @todo the module size stuff doesn't quite make sense yet. Need to look at segments first, I guess. */
+    pThis->iNextSymbolOrdinal = 0;
+    pThis->iNextLineOrdinal = 0;
 
     pMod->pDbgVt = &g_rtDbgModVtDbgContainer;

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

@@ -66 +66 @@
      * This combines probing and opening.
      *
-     * @returns VBox status code. No informational returns defined.
+     * @returns IPRT status code. No informational returns defined.
      *
      * @param   pMod        Pointer to the module that is being opened.
@@ -116 +116 @@
      * This combines probing and opening.
      *
-     * @returns VBox status code. No informational returns defined.
+     * @returns IPRT status code. No informational returns defined.
      *
      * @param   pMod        Pointer to the module that is being opened.
@@ -143 +143 @@
     DECLCALLBACKMEMBER(int, pfnClose)(PRTDBGMODINT pMod);
 
+
+
     /**
      * Converts an image relative virtual address address to a segmented address.
@@ -153 +155 @@
     DECLCALLBACKMEMBER(RTDBGSEGIDX, pfnRvaToSegOff)(PRTDBGMODINT pMod, RTUINTPTR uRva, PRTUINTPTR poffSeg);
 
+
+
+    /**
+     * Adds a segment to the module (optional).
+     *
+     * @returns IPRT status code.
+     * @retval  VERR_NOT_SUPPORTED if the interpreter doesn't support this feature.
+     * @retval  VERR_DBG_SEGMENT_INDEX_CONFLICT if the segment index exists already.
+     *
+     * @param   pMod        Pointer to the module structure.
+     * @param   uRva        The segment image relative address.
+     * @param   cb          The segment size.
+     * @param   pszName     The segment name.
+     * @param   cchName     The length of the segment name.
+     * @param   fFlags      Segment flags.
+     * @param   piSeg       The segment index or NIL_RTDBGSEGIDX on input.
+     *                      The assigned segment index on successful return.
+     *                      Optional.
+     */
+    DECLCALLBACKMEMBER(int, pfnSegmentAdd)(PRTDBGMODINT pMod, RTUINTPTR uRva, RTUINTPTR cb, const char *pszName, size_t cchName,
+                                           uint32_t fFlags, PRTDBGSEGIDX piSeg);
+
+    /**
+     * Gets the segment count.
+     *
+     * @returns Number of segments.
+     * @retval  NIL_RTDBGSEGIDX if unknown.
+     *
+     * @param   pMod        Pointer to the module structure.
+     */
+    DECLCALLBACKMEMBER(RTDBGSEGIDX, pfnSegmentCount)(PRTDBGMODINT pMod);
+
+    /**
+     * Gets information about a segment.
+     *
+     * @returns IPRT status code.
+     * @retval  VERR_DBG_INVALID_SEGMENT_INDEX if iSeg is too high.
+     *
+     * @param   pMod        Pointer to the module structure.
+     * @param   iSeg        The segment.
+     * @param   pSegInfo    Where to store the segment information.
+     */
+    DECLCALLBACKMEMBER(int, pfnSegmentByIndex)(PRTDBGMODINT pMod, RTDBGSEGIDX iSeg, RTDBGSEGMENT pSegInfo);
+
+
+
     /**
      * Adds a symbol to the module (optional).
      *
-     * @returns VBox status code.
+     * @returns IPRT  code.
      * @retval  VERR_NOT_SUPPORTED if the interpreter doesn't support this feature.
      *
@@ -165 +213 @@
      * @param   off         The offset into the segment.
      * @param   cb          The area covered by the symbol. 0 is fine.
+     * @param   piOrdinal   Where to return the symbol ordinal on success. If the
+     *                      interpreter doesn't do ordinals, this will be set to
+     *                      UINT32_MAX. Optional
      */
     DECLCALLBACKMEMBER(int, pfnSymbolAdd)(PRTDBGMODINT pMod, const char *pszSymbol, size_t cchSymbol,
-                                          uint32_t iSeg, RTUINTPTR off, RTUINTPTR cb, uint32_t fFlags);
+                                          uint32_t iSeg, RTUINTPTR off, RTUINTPTR cb, uint32_t fFlags,
+                                          uint32_t *piOrdinal);
+
+    /**
+     * Gets the number of symbols in the module.
+     *
+     * This is used for figuring out the max value to pass to pfnSymbolByIndex among
+     * other things.
+     *
+     * @returns The number of symbols, UINT32_MAX if not known/supported.
+     *
+     * @param   pMod        Pointer to the module structure.
+     */
+    DECLCALLBACKMEMBER(uint32_t, pfnSymbolCount)(PRTDBGMODINT pMod);
+
+    /**
+     * Queries symbol information by ordinal number.
+     *
+     * @returns IPRT status code.
+     * @retval  VINF_SUCCESS on success, no informational status code.
+     * @retval  VERR_DBG_NO_SYMBOLS if there aren't any symbols.
+     * @retval  VERR_NOT_SUPPORTED if lookup by ordinal is not supported.
+     * @retval  VERR_SYMBOL_NOT_FOUND if there is no symbol at that index.
+     *
+     * @param   pMod        Pointer to the module structure.
+     * @param   iSymbol     The symbol ordinal number.
+     * @param   pSymbol     Where to store the symbol information.
+     */
+    DECLCALLBACKMEMBER(int, pfnSymbolByOrdinal)(PRTDBGMODINT pMod, uint32_t iSymbol, PRTDBGSYMBOL pSymbol);
 
     /**
      * Queries symbol information by symbol name.
      *
-     * @returns VBox status code.
+     * @returns IPRT status code.
      * @retval  VINF_SUCCESS on success, no informational status code.
-     * @retval  VERR_RTDBGMOD_NO_SYMBOLS if there aren't any symbols.
+     * @retval  VERR_DBG_NO_SYMBOLS if there aren't any symbols.
      * @retval  VERR_SYMBOL_NOT_FOUND if no suitable symbol was found.
      *
@@ -190 +269 @@
      * address equal or lower than the requested.
      *
-     * @returns VBox status code.
+     * @returns IPRT status code.
      * @retval  VINF_SUCCESS on success, no informational status code.
-     * @retval  VERR_RTDBGMOD_NO_SYMBOLS if there aren't any symbols.
+     * @retval  VERR_DBG_NO_SYMBOLS if there aren't any symbols.
      * @retval  VERR_SYMBOL_NOT_FOUND if no suitable symbol was found.
      *
@@ -204 +283 @@
     DECLCALLBACKMEMBER(int, pfnSymbolByAddr)(PRTDBGMODINT pMod, uint32_t iSeg, RTUINTPTR off, PRTINTPTR poffDisp, PRTDBGSYMBOL pSymbol);
 
+
+
     /**
      * Adds a line number to the module (optional).
      *
-     * @returns VBox status code.
+     * @returns IPRT status code.
      * @retval  VERR_NOT_SUPPORTED if the interpreter doesn't support this feature.
      *
@@ -215 +296 @@
      * @param   iSeg        The segment number (0-based).
      * @param   off         The offset into the segment.
-     */
-    DECLCALLBACKMEMBER(int, pfnLineAdd)(PRTDBGMODINT pMod, const char *pszFile, size_t cchFile, uint32_t uLineNo, uint32_t iSeg, RTUINTPTR off);
+     * @param   piOrdinal   Where to return the line number ordinal on success. If
+     *                      the interpreter doesn't do ordinals, this will be set to
+     *                      UINT32_MAX. Optional
+     */
+    DECLCALLBACKMEMBER(int, pfnLineAdd)(PRTDBGMODINT pMod, const char *pszFile, size_t cchFile, uint32_t uLineNo,
+                                        uint32_t iSeg, RTUINTPTR off, uint32_t *piOrdinal);
+
+    /**
+     * Gets the number of line numbers in the module.
+     *
+     * @returns The number or UINT32_MAX if not known/supported.
+     *
+     * @param   pMod        Pointer to the module structure.
+     */
+    DECLCALLBACKMEMBER(uint32_t, pfnLineCount)(PRTDBGMODINT pMod);
+
+    /**
+     * Queries line number information by ordinal number.
+     *
+     * @returns IPRT status code.
+     * @retval  VINF_SUCCESS on success, no informational status code.
+     * @retval  VERR_DBG_NO_LINE_NUMBERS if there aren't any line numbers.
+     * @retval  VERR_DBG_LINE_NOT_FOUND if there is no line number with that
+     *          ordinal.
+     *
+     * @param   pMod        Pointer to the module structure.
+     * @param   iOrdinal    The line number ordinal number.
+     * @param   pLine       Where to store the information about the line number.
+     */
+    DECLCALLBACKMEMBER(int, pfnLineByOrdinal)(PRTDBGMODINT pMod, uint32_t iOrdinal, PRTDBGLINE pLine);
 
     /**
      * Queries line number information by address.
      *
-     * @returns VBox status code.
+     * @returns IPRT status code.
      * @retval  VINF_SUCCESS on success, no informational status code.
-     * @retval  VERR_RTDBGMOD_NO_LINE_NUMBERS if there aren't any line numbers.
-     * @retval  VERR_RTDBGMOD_LINE_NOT_FOUND if no suitable line number was found.
+     * @retval  VERR_DBG_NO_LINE_NUMBERS if there aren't any line numbers.
+     * @retval  VERR_DBG_LINE_NOT_FOUND if no suitable line number was found.
      *
      * @param   pMod        Pointer to the module structure.
@@ -234 +343 @@
      */
     DECLCALLBACKMEMBER(int, pfnLineByAddr)(PRTDBGMODINT pMod, uint32_t iSeg, RTUINTPTR off, PRTINTPTR poffDisp, PRTDBGLINE pLine);
+
 
     /** For catching initialization errors (RTDBGMODVTDBG_MAGIC). */