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

Timestamp:

May 17, 2013 5:21:23 PM (12 years ago)

Author:

vboxsync

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

85849

Message:

IPRT: Dwarf and ELF fixes.

Location:

trunk/src/VBox/Runtime/include/internal

Files:

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

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

@@ -156 +156 @@
 
     /**
+     * Converts an image relative virtual address to a segment:offset.
+     *
+     * @returns IPRT status code.
+     *
+     * @param   pMod            Pointer to the loader module structure.
+     * @param   Rva             The RVA to convert.
+     * @param   piSeg           The segment index.
+     * @param   poffSeg         Where to return the segment offset.
+     */
+    DECLCALLBACKMEMBER(int, pfnRvaToSegOffset)(PRTDBGMODINT pMod, RTLDRADDR Rva, uint32_t *piSeg, PRTLDRADDR poffSeg);
+
+    /**
      * Creates a read-only mapping of a part of the image file.
      *
@@ -161 +173 @@
      *
      * @param   pMod            Pointer to the module structure.
+     * @param   iDbgInfo        The debug info ordinal number if the request
+     *                          corresponds exactly to a debug info part from
+     *                          pfnEnumDbgInfo.  Otherwise, pass UINT32_MAX.
      * @param   off             The offset into the image file.
      * @param   cb              The number of bytes to map.
      * @param   ppvMap          Where to return the mapping address on success.
-     */
-    DECLCALLBACKMEMBER(int, pfnMapPart)(PRTDBGMODINT pMod, RTFOFF off, size_t cb, void const **ppvMap);
+     *
+     * @remarks Fixups will only be applied if @a iDbgInfo is specified.
+     */
+    DECLCALLBACKMEMBER(int, pfnMapPart)(PRTDBGMODINT pMod, uint32_t iDbgInfo, RTFOFF off, size_t cb, void const **ppvMap);
 
     /**

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

@@ -297 +297 @@
      *
      * @param   pMod            Pointer to the loader module structure.
-     * @param   iSeg            The segment index.
-     * @param   offSeg          The segment offset.
-     * @param   pRva            Where to return the RVA.
+     * @param   Rva             The RVA to convert.
+     * @param   piSeg           Where to return the segment index.
+     * @param   poffSeg         Where to return the segment offset.
      * @remark  This is an optional entry point that can be NULL.
      */
     DECLCALLBACKMEMBER(int, pfnRvaToSegOffset)(PRTLDRMODINTERNAL pMod, RTLDRADDR Rva, uint32_t *piSeg, PRTLDRADDR poffSeg);
+
+    /**
+     * Reads a debug info part (section) from the image.
+     *
+     * This is primarily needed for getting DWARF sections in ELF image with fixups
+     * applied and won't be required by most other loader backends.
+     *
+     * @returns IPRT status code.
+     *
+     * @param   pvBuf           The buffer to read into.
+     * @param   iDbgInfo        The debug info ordinal number if the request
+     *                          corresponds exactly to a debug info part from
+     *                          pfnEnumDbgInfo.  Otherwise, pass UINT32_MAX.
+     * @param   off             The offset into the image file.
+     * @param   cb              The number of bytes to read.
+     * @param   pMod            Pointer to the loader module structure.
+     */
+    DECLCALLBACKMEMBER(int, pfnReadDbgInfo)(PRTLDRMODINTERNAL pMod, uint32_t iDbgInfo, RTFOFF off, size_t cb, void *pvBuf);
 
     /** Dummy entry to make sure we've initialized it all. */
@@ -458 +476 @@
 
 
-DECLHIDDEN(int) rtLdrReadAt(RTLDRMOD hLdrMod, void *pvBuf, RTFOFF off, size_t cb);
+DECLHIDDEN(int) rtLdrReadAt(RTLDRMOD hLdrMod, void *pvBuf, uint32_t iDbgInfo, RTFOFF off, size_t cb);
 
 RT_C_DECLS_END