44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * IPRT - Debug Module Reader For Microsoft CodeView and COFF.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Based on the following documentation (plus guess work and googling):
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * - "Tools Interface Standard (TIS) Formats Specification for Windows",
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * dated February 1993, version 1.0.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * - "Visual C++ 5.0 Symbolic Debug Information Specification" chapter of
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * SPECS.CHM from MSDN Library October 2001.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * - "High Level Languages Debug Table Documentation", aka HLLDBG.HTML, aka
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * IBMHLL.HTML, last changed 1996-07-08.
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync * Testcases using RTLdrFlt:
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync * - VBoxPcBios.sym at 0xf0000.
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync * - NT4 kernel PE image (coff syms).
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Copyright (C) 2013 Oracle Corporation
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * available from http://www.virtualbox.org. This file is free software;
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * you can redistribute it and/or modify it under the terms of the GNU
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * General Public License (GPL) as published by the Free Software
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * The contents of this file may alternatively be used under the terms
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * of the Common Development and Distribution License Version 1.0
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * VirtualBox OSE distribution, in which case the provisions of the
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * CDDL are applicable instead of those of the GPL.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * You may elect to license modified versions of this file under the
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * terms and conditions of either the GPL or the CDDL or both.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/*******************************************************************************
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync* Header Files *
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync*******************************************************************************/
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/*******************************************************************************
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync* Structures and Typedefs *
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync*******************************************************************************/
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * CodeView Header. There are two of this, base header at the start of the debug
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * information and a trailing header at the end.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The magic ('NBxx'), see RTCVHDR_MAGIC_XXX. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Base header: Subsection directory offset relative to this header (start).
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Trailing header: Offset of the base header relative to the end of the file.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Called lfoBase, lfaBase, lfoDirectory, lfoDir and probably other things in
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * the various specs/docs available. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Pointer to a CodeView header. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @name CodeView magic values (RTCVHDR::u32Magic).
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** CodeView from Visual C++ 5.0. Specified in the 2001 MSDN specs.chm file. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync#define RTCVHDR_MAGIC_NB11 RT_MAKE_U32_FROM_U8('N', 'B', '1', '1')
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** External PDB reference (often referred to as PDB 2.0). */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync#define RTCVHDR_MAGIC_NB10 RT_MAKE_U32_FROM_U8('N', 'B', '1', '0')
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** CodeView v4.10, packed. Specified in the TIS document. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync#define RTCVHDR_MAGIC_NB09 RT_MAKE_U32_FROM_U8('N', 'B', '0', '9')
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** CodeView v4.00 thru v4.05. Specified in the TIS document? */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync#define RTCVHDR_MAGIC_NB08 RT_MAKE_U32_FROM_U8('N', 'B', '0', '8')
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Quick C for Windows 1.0 debug info. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync#define RTCVHDR_MAGIC_NB07 RT_MAKE_U32_FROM_U8('N', 'B', '0', '7')
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Emitted by ILINK indicating incremental link. Comparable to NB05? */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync#define RTCVHDR_MAGIC_NB06 RT_MAKE_U32_FROM_U8('N', 'B', '0', '6')
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Emitted by LINK version 5.20 and later before packing. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync#define RTCVHDR_MAGIC_NB05 RT_MAKE_U32_FROM_U8('N', 'B', '0', '5')
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Emitted by IBM ILINK for HLL (similar to NB02 in many ways). */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync#define RTCVHDR_MAGIC_NB04 RT_MAKE_U32_FROM_U8('N', 'B', '0', '4')
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Emitted by LINK version 5.10 (or similar OMF linkers), as shipped with
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Microsoft C v6.0 for example. More or less entirely 16-bit. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync#define RTCVHDR_MAGIC_NB02 RT_MAKE_U32_FROM_U8('N', 'B', '0', '2')
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/* No idea what NB03 might have been. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** AIX debugger format according to "IBM OS/2 16/32-bit Object Module Format
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * (OMF) and Linear eXecutable Module Format (LX)" revision 10 (LXOMF.PDF). */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync#define RTCVHDR_MAGIC_NB01 RT_MAKE_U32_FROM_U8('N', 'B', '0', '1')
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Ancient CodeView format according to LXOMF.PDF. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync#define RTCVHDR_MAGIC_NB00 RT_MAKE_U32_FROM_U8('N', 'B', '0', '0')
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @name CV directory headers.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Really old CV directory header used with NB00 and NB02.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Uses 16-bit directory entires (RTCVDIRENT16).
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The number of directory entries. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Pointer to a old CV directory header. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Simple 32-bit CV directory base header, used by NB04 (aka IBM HLL).
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The number of bytes of this header structure. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The number of bytes per entry. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The number of directory entries. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Pointer to a 32-bit CV directory header. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Extended 32-bit CV directory header as specified in the TIS doc.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * The two extra fields seems to never have been assigned any official purpose.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** This starts the same way as the NB04 header. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Tentatively decleared as the offset to the next directory generated by
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * the incremental linker. Haven't seen this used yet. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Flags, non defined apparently, so MBZ. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Pointer to an extended 32-bit CV directory header. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * 16-bit CV directory entry used with NB00 and NB02.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Subsection type (RTCVSST). */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Which module (1-based, 0xffff is special). */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The lowe offset of this subsection relative to the base CV header. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The high part of the subsection offset. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The size of the subsection. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Pointer to a 16-bit CV directory entry. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * 32-bit CV directory entry used starting with NB04.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Subsection type (RTCVSST). */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Which module (1-based, 0xffff is special). */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The offset of this subsection relative to the base CV header. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The size of the subsection. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Pointer to a 32-bit CV directory entry. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Pointer to a const 32-bit CV directory entry. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * CodeView subsection types.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** @name NB00, NB02 and NB04 subsection types.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * The actual format of each subsection varies between NB04 and the others,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * and it may further vary in NB04 depending on the module type.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** @name NB09, NB11 (and possibly NB05, NB06, NB07, and NB08) subsection types.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Pointer to a CV subsection type value. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Pointer to a const CV subsection type value. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * CV4 module segment info.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The segment number. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Explicit padding. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Offset into the segment. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The size of the contribution. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * CV4 segment map header.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Number of segments descriptors in the table. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Number of logical segment descriptors. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Pointer to a CV4 segment map header. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Pointer to a const CV4 segment map header. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * CV4 Segment map descriptor entry.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Segment flags. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The overlay number. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Group index into this segment descriptor array. 0 if not relevant.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * The group descriptors are found in the second half of the table. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Complicated. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Offset (byte) into the kCvSst_SegName table of the segment name, or
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * 0xffff. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Offset (byte) into the kCvSst_SegName table of the class name, or 0xffff. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Offset into the physical segment. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Size of segment. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Pointer to a segment map descriptor entry. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Pointer to a const segment map descriptor entry. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @name RTCVSEGMAPDESC_F_XXX - RTCVSEGMAPDESC::fFlags values.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * CV4 segment map subsection.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The header. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Descriptor array. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Pointer to a segment map subsection. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Pointer to a const segment map subsection. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Global symbol table header, used by kCvSst_GlobalSym and kCvSst_GlobalPub.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The symbol hash function. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The address hash function. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The amount of symbol information following immediately after the header. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The amount of symbol hash tables following the symbols. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The amount of address hash tables following the symbol hash tables. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Pointer to a global symbol table header. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Pointer to a const global symbol table header. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsynctypedef RTCVGLOBALSYMTABHDR const *PCRTCVGLOBALSYMTABHDR;
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** @name Symbols that doesn't change with compilation model or target machine.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** @name Symbols with 16:16 addresses.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** @name Symbols with 16:32 addresses.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** @name Symbols for MIPS.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** @name Symbols for Microsoft CodeView.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** The $$SYMBOL table signature for CV4. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync#define RTCVSYMBOLS_SIGNATURE_CV4 UINT32_C(0x00000001)
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync * Directory sorting order.
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /** Ordered by module. */
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /** Ordered by module, but 0 modules at the end. */
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /** Ordered by section, with global modules at the end. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * File type.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Executable image. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** A DBG-file with a IMAGE_SEPARATE_DEBUG_HEADER. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** A PDB file. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Some other kind of file with CV at the end. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The end of the valid values. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Type blowup. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * CodeView debug info reader instance.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Using a container for managing the debug info. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** @name Codeview details
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The code view magic (used as format indicator). */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The offset of the CV debug info in the file. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The size of the CV debug info. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The offset of the subsection directory (relative to offBase). */
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /** The directory order. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** @name COFF details.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Offset of the COFF header. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The size of the COFF debug info. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The COFF debug info header. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The file type. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The file handle (if external). */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Pointer to the module (no reference retained). */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The image size, if we know it. This is 0 if we don't know it. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Indicates that we've loaded segments intot he container already. */
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /** Alternative address translation method for DOS frames. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** @name Codeview Parsing state.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Number of directory entries. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The directory (converted to 32-bit). */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Current debugging style when parsing modules. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Current debugging style version (HLL only). */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The segment map (if present). */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** Segment names. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** The size of the segment names. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Pointer to a codeview debug info reader instance. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Pointer to a const codeview debug info reader instance. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Subsection callback.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @returns IPRT status code.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pThis The CodeView debug info reader instance.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pvSubSect Pointer to the subsection data.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param cbSubSect The size of the subsection data.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pDirEnt The directory entry.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsynctypedef DECLCALLBACK(int) FNDBGMODCVSUBSECTCALLBACK(PRTDBGMODCV pThis, void const *pvSubSect, size_t cbSubSect,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Pointer to a subsection callback. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsynctypedef FNDBGMODCVSUBSECTCALLBACK *PFNDBGMODCVSUBSECTCALLBACK;
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/*******************************************************************************
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync* Defined Constants And Macros *
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync*******************************************************************************/
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Light weight assert + return w/ fixed status code. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync#define RTDBGMODCV_CHECK_RET_BF(a_Expr, a_LogArgs) \
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("RTDbgCv: Check failed on line %d: " #a_Expr "\n", __LINE__)); \
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /*return VERR_CV_BAD_FORMAT;*/ \
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync } while (0)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Light weight assert + return w/ fixed status code. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("RTDbgCv: Check failed on line %d: " #a_Expr "\n", __LINE__)); \
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /*return VERR_CV_BAD_FORMAT;*/ \
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync } while (0)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Reads CodeView information.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @returns IPRT status.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pThis The CodeView reader instance.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param off The offset to start reading at, relative to the
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * CodeView base header.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pvBuf The buffer to read into.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param cb How many bytes to read.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic int rtDbgModCvReadAt(PRTDBGMODCV pThis, uint32_t off, void *pvBuf, size_t cb)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = pThis->pMod->pImgVt->pfnReadAt(pThis->pMod, UINT32_MAX, off + pThis->offBase, pvBuf, cb);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = RTFileReadAt(pThis->hFile, off + pThis->offBase, pvBuf, cb, NULL);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Reads CodeView information into an allocated buffer.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @returns IPRT status.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pThis The CodeView reader instance.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param off The offset to start reading at, relative to the
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * CodeView base header.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param ppvBuf Where to return the allocated buffer on success.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param cb How many bytes to read.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic int rtDbgModCvReadAtAlloc(PRTDBGMODCV pThis, uint32_t off, void **ppvBuf, size_t cb)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = pThis->pMod->pImgVt->pfnReadAt(pThis->pMod, UINT32_MAX, off + pThis->offBase, pvBuf, cb);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = RTFileReadAt(pThis->hFile, off + pThis->offBase, pvBuf, cb, NULL);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Gets a name string for a subsection type.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @returns Section name (read only).
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param uSubSectType The subsection type.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic const char *rtDbgModCvGetSubSectionName(uint16_t uSubSectType)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync case kCvSst_OldLibraries: return "sstOldLibraries";
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync case kCvSst_OldCompacted: return "sstOldCompacted";
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync case kCvSst_OldSrcLines3: return "sstOldSrcLines3";
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTStrPrintf(s_sz, sizeof(s_sz), "Unknown%#x", uSubSectType);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Adds a symbol to the container.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @returns IPRT status code
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pThis The CodeView debug info reader instance.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param iSeg Segment number.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param off Offset into the segment
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pchName The symbol name (not necessarily terminated).
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param cchName The symbol name length.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param fFlags Flags reserved for future exploits, MBZ.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic int rtDbgModCvAddSymbol(PRTDBGMODCV pThis, uint32_t iSeg, uint64_t off, const char *pchName,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync const char *pszName = RTStrCacheEnterN(g_hDbgModStrCache, pchName, cchName);
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync Log2(("CV Sym: %04x:%08x %.*s\n", iSeg, off, cchName, pchName));
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync Log(("Invalid segment index/offset %#06x:%08x for symbol %.*s\n", iSeg, off, cchName, pchName));
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync if (off <= pThis->pSegMap->aDescs[iSeg - 1].cb + pThis->pSegMap->aDescs[iSeg - 1].off)
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /* Workaround for VGABIOS where _DATA symbols like vgafont8 are
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync reported in the VGAROM segment. */
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync uint64_t uAddrSym = off + ((uint32_t)pThis->pSegMap->aDescs[iSeg - 1].iFrame << 4);
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync while (j-- > 0)
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync uint64_t uAddrFirst = (uint64_t)pThis->pSegMap->aDescs[j].off
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync + ((uint32_t)pThis->pSegMap->aDescs[j].iFrame << 4);
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync if (uAddrSym - uAddrFirst < pThis->pSegMap->aDescs[j].cb)
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync Log(("CV addr fix: %04x:%08x -> %04x:%08x\n", iSeg, off, j + 1, uAddrSym - uAddrFirst));
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync Log(("Invalid segment index/offset %#06x:%08x for symbol %.*s [2]\n", iSeg, off, cchName, pchName));
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync Log(("Invalid segment index/offset %#06x:%08x for symbol %.*s\n", iSeg, off, cchName, pchName));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync if (pThis->pSegMap->aDescs[iSeg - 1].fFlags & RTCVSEGMAPDESC_F_ABS)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync int rc = RTDbgModSymbolAdd(pThis->hCnt, pszName, iSeg, off, 0, 0 /*fFlags*/, NULL);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("Symbol: %04x:%08x %.*s [%Rrc]\n", iSeg, off, cchName, pchName, rc));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync if (rc == VERR_DBG_ADDRESS_CONFLICT || rc == VERR_DBG_DUPLICATE_SYMBOL)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("Symbol: %04x:%08x %.*s\n", iSeg, off, cchName, pchName));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Parses a CV4 symbol table, adding symbols to the container.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @returns IPRT status code
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pThis The CodeView debug info reader instance.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pbSymTab The symbol table.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param cbSymTab The size of the symbol table.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param fFlags Flags reserved for future exploits, MBZ.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic int rtDbgModCvSsProcessV4SymTab(PRTDBGMODCV pThis, void const *pvSymTab, size_t cbSymTab, uint32_t fFlags)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log3((" %p: uSymType=%#06x LB %#x\n", pbRecStart - (uint8_t *)pvSymTab, uSymType, cbRec));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_RET_BF(cbRec >= 2 && cbRec <= cbSymTab, ("cbRec=%#x cbSymTab=%#x\n", cbRec, cbSymTab));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(cbRec > 2 + 2+2+2+1);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(cbRec >= 2 + 2+2+2+1 + cchName);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = rtDbgModCvAddSymbol(pThis, iSeg, off, uCursor.pch, cchName, 0);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(cbRec > 2 + 4+2+2+1);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(cbRec >= 2 + 4+2+2+1 + cchName);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = rtDbgModCvAddSymbol(pThis, iSeg, off, uCursor.pch, cchName, 0);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** @todo add GProc and LProc so we can gather sizes as well as just symbols. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /*else: shorter records can be used for alignment, I guess. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @callback_method_impl{FNDBGMODCVSUBSECTCALLBACK,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Parses kCvSst_GlobalPub, kCvSst_GlobalSym and kCvSst_StaticSym subsections,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * adding symbols it finds to the container.} */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncrtDbgModCvSs_GlobalPub_GlobalSym_StaticSym(PRTDBGMODCV pThis, void const *pvSubSect, size_t cbSubSect, PCRTCVDIRENT32 pDirEnt)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync PCRTCVGLOBALSYMTABHDR pHdr = (PCRTCVGLOBALSYMTABHDR)pvSubSect;
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Quick data validation.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2(("RTDbgModCv: %s: uSymHash=%#x uAddrHash=%#x cbSymbols=%#x cbSymHash=%#x cbAddrHash=%#x\n",
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rtDbgModCvGetSubSectionName(pDirEnt->uSubSectType), pHdr->uSymHash,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync pHdr->uAddrHash, pHdr->cbSymbols, pHdr->cbSymHash, pHdr->cbAddrHash));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(cbSubSect >= sizeof(RTCVGLOBALSYMTABHDR));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF((uint64_t)pHdr->cbSymbols + pHdr->cbSymHash + pHdr->cbAddrHash <= cbSubSect - sizeof(*pHdr));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(pHdr->uSymHash < 0x20);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(pHdr->uAddrHash < 0x20);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Parse the symbols.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync return rtDbgModCvSsProcessV4SymTab(pThis, pHdr + 1, pHdr->cbSymbols, 0);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @callback_method_impl{FNDBGMODCVSUBSECTCALLBACK,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Parses kCvSst_Module subsection, storing the debugging style in pThis.} */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncrtDbgModCvSs_Module(PRTDBGMODCV pThis, void const *pvSubSect, size_t cbSubSect, PCRTCVDIRENT32 pDirEnt)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(cbSubSect >= 2 + 2 + 2 + 2 + 0 + 1);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(cbSubSect >= 2 + 2 + 2 + 2 + cSegs * 12U + 1 + cchName);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync const char *pchName = (const char *)&uCursor.pu8[cSegs * 12 + 1];
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2(("RTDbgModCv: Module: iOverlay=%#x iLib=%#x cSegs=%#x Style=%c%c (%#x) %.*s\n", iOverlay, iLib, cSegs,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RT_BYTE1(pThis->uCurStyle), RT_BYTE2(pThis->uCurStyle), pThis->uCurStyle, cchName, pchName));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(pThis->uCurStyle == RT_MAKE_U16('C', 'V'));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync PCRTCVMODSEGINFO32 paSegs = (PCRTCVMODSEGINFO32)uCursor.pv;
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2((" #%02u: %04x:%08x LB %08x\n", iSeg, paSegs[iSeg].iSeg, paSegs[iSeg].off, paSegs[iSeg].cb));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @callback_method_impl{FNDBGMODCVSUBSECTCALLBACK,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Parses kCvSst_Symbols, kCvSst_PublicSym and kCvSst_AlignSym subsections,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * adding symbols it finds to the container.} */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncrtDbgModCvSs_Symbols_PublicSym_AlignSym(PRTDBGMODCV pThis, void const *pvSubSect, size_t cbSubSect, PCRTCVDIRENT32 pDirEnt)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(pThis->uCurStyle == RT_MAKE_U16('C', 'V'));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync uint32_t u32Signature = *(uint32_t const *)pvSubSect;
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_RET_BF(u32Signature == RTCVSYMBOLS_SIGNATURE_CV4,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync ("%#x, expected %#x\n", u32Signature, RTCVSYMBOLS_SIGNATURE_CV4));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync return rtDbgModCvSsProcessV4SymTab(pThis, (uint8_t const *)pvSubSect + 4, cbSubSect - 4, 0);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic int rtDbgModCvLoadSegmentMap(PRTDBGMODCV pThis)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Search for the segment map and segment names. They will be at the end of the directory.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync while (i-- > 0)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync if (pThis->paDirEnts[i].uSubSectType == kCvSst_SegMap)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync else if (pThis->paDirEnts[i].uSubSectType == kCvSst_SegName)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("RTDbgModCv: No segment map present, using segment indexes as is then...\n"));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_RET_BF(pThis->paDirEnts[iSegMap].cb >= sizeof(RTCVSEGMAPHDR),
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync ("Bad sstSegMap entry: cb=%#x\n", pThis->paDirEnts[iSegMap].cb));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(iSegNames == UINT32_MAX || pThis->paDirEnts[iSegNames].cb > 0);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Read them into memory.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync int rc = rtDbgModCvReadAtAlloc(pThis, pThis->paDirEnts[iSegMap].off, (void **)&pThis->pSegMap,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync pThis->cbSegNames = pThis->paDirEnts[iSegNames].cb;
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = rtDbgModCvReadAtAlloc(pThis, pThis->paDirEnts[iSegNames].off, (void **)&pThis->pszzSegNames,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(!pThis->pszzSegNames || !pThis->pszzSegNames[pThis->cbSegNames - 1]); /* must be terminated */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Use local pointers to avoid lots of indirection and typing. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync PRTCVSEGMAPDESC paDescs = &pThis->pSegMap->aDescs[0];
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * If there are only logical segments, assume a direct mapping.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * PE images, like the NT4 kernel, does it like this.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync bool const fNoGroups = pHdr->cSegs == pHdr->cLogSegs;
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync * The PE image has an extra section/segment for the headers, the others
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync * doesn't. PE images doesn't have DOS frames. So, figure the image type now.
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync enmImgFmt = pThis->pMod->pImgVt->pfnGetFormat(pThis->pMod);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Validate and display it all.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2(("RTDbgModCv: SegMap: cSegs=%#x cLogSegs=%#x (cbSegNames=%#x)\n", pHdr->cSegs, pHdr->cLogSegs, pThis->cbSegNames));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_RET_BF(pThis->paDirEnts[iSegMap].cb >= sizeof(*pHdr) + pHdr->cSegs * sizeof(paDescs[0]),
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync ("SegMap is out of bounds: cbSubSect=%#x cSegs=%#x\n", pThis->paDirEnts[iSegMap].cb, pHdr->cSegs));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(pHdr->cSegs >= pHdr->cLogSegs);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2(("Logical segment descriptors: %u\n", pHdr->cLogSegs));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2(("Group/Physical descriptors: %u\n", pHdr->cSegs - pHdr->cLogSegs));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync uint16_t idx = i < pHdr->cLogSegs ? i : i - pHdr->cLogSegs;
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2((" #%02u: %#010x LB %#010x flags=%#06x ovl=%#06x group=%#06x frame=%#06x iSegName=%#06x iClassName=%#06x %s\n",
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync idx, paDescs[i].off, paDescs[i].cb, paDescs[i].fFlags, paDescs[i].iOverlay, paDescs[i].iGroup,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync paDescs[i].iFrame, paDescs[i].offSegName, paDescs[i].offClassName, szFlags));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(paDescs[i].offSegName == UINT16_MAX || paDescs[i].offSegName < pThis->cbSegNames);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(paDescs[i].offClassName == UINT16_MAX || paDescs[i].offClassName < pThis->cbSegNames);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync const char *pszName = paDescs[i].offSegName != UINT16_MAX
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync const char *pszClass = paDescs[i].offClassName != UINT16_MAX
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2((" pszName=%s pszClass=%s\n", pszName, pszClass));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Validate the group link. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(paDescs[i].iGroup == 0 || !(paDescs[i].fFlags & RTCVSEGMAPDESC_F_GROUP));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF( paDescs[i].iGroup == 0
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF( paDescs[i].iGroup == 0
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync || (paDescs[paDescs[i].iGroup].fFlags & RTCVSEGMAPDESC_F_GROUP));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(!(paDescs[i].fFlags & RTCVSEGMAPDESC_F_GROUP) || paDescs[i].off == 0); /* assumed below */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(paDescs[i].iGroup == 0);
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync && (paDescs[i].fFlags & (RTCVSEGMAPDESC_F_SEL | RTCVSEGMAPDESC_F_ABS))
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync fHaveDosFrames = true; /* BIOS, only groups with frames. */
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync * Further valiations based on fHaveDosFrames or not.
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(paDescs[i].iOverlay == 0);
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF( (paDescs[i].fFlags & (RTCVSEGMAPDESC_F_SEL | RTCVSEGMAPDESC_F_ABS))
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync || (paDescs[i].fFlags & (RTCVSEGMAPDESC_F_SEL | RTCVSEGMAPDESC_F_ABS))
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(!(paDescs[i].fFlags & RTCVSEGMAPDESC_F_ABS));
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(paDescs[i].off == 0);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Modify the groups index to be the loader segment index instead, also
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * add the segments to the container if we haven't done that already.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Guess work: Group can be implicit if used. Observed Visual C++ v1.5,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync omitting the CODE group. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync if ( !(paDescs[i].fFlags & (RTCVSEGMAPDESC_F_GROUP | RTCVSEGMAPDESC_F_ABS))
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync if (pszGroup0 == NULL && paDescs[i].offClassName != UINT16_MAX)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync pszGroup0 = pThis->pszzSegNames + paDescs[i].offClassName;
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync uint64_t offEnd = (uint64_t)paDescs[i].off + paDescs[i].cb;
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Add the segments.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Note! The RVAs derived from this exercise are all wrong. :-/
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Note! We don't have an image loader, so we cannot add any fake sections. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** @todo Try see if we can figure something out from the frame value later. */
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync Assert(!pThis->pMod->pImgVt); Assert(pThis->enmType != RTCVFILETYPE_DBG);
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync rc = RTDbgModSegmentAdd(pThis->hCnt, 0, cbGroup0, pszGroup0 ? pszGroup0 : "Seg00", 0 /*fFlags*/, NULL);
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync for (i = 0; RT_SUCCESS(rc) && i < pHdr->cSegs; i++)
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync if ((paDescs[i].fFlags & RTCVSEGMAPDESC_F_GROUP) || fNoGroups)
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync pszName = pThis->pszzSegNames + paDescs[i].offSegName;
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync RTStrPrintf(szName, sizeof(szName), "Seg%02u", iSeg);
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync rc = RTDbgModSegmentAdd(pThis->hCnt, uRva, paDescs[i].cb, pszName, 0 /*fFlags*/, NULL);
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /* The map is not sorted by RVA, very annoying, but I'm countering
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync by being lazy and slow about it. :-) Btw. this is the BIOS case. */
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /* Figure image base address. */
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync for (i = 0; RT_SUCCESS(rc) && i < pHdr->cSegs; i++)
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync uint64_t uAddr = (uint64_t)paDescs[i].off + ((uint32_t)paDescs[i].iFrame << 4);
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /* Add the segments. */
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync for (i = 0; RT_SUCCESS(rc) && i < pHdr->cSegs; i++)
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /* Figure out the next one. */
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync uint64_t uAddr = (uint64_t)paDescs[j].off + ((uint32_t)paDescs[j].iFrame << 4);
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /* Add it. */
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync pszName = pThis->pszzSegNames + paDescs[iBest].offSegName;
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTStrPrintf(szName, sizeof(szName), "Seg%02u", iSeg);
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync Log(("CV: %#010x LB %#010x %s uRVA=%#010x iBest=%u cOverlaps=%u\n",
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync uBestAddr, paDescs[iBest].cb, szName, uBestAddr - uImageBase, iBest, cOverlaps));
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync rc = RTDbgModSegmentAdd(pThis->hCnt, uBestAddr - uImageBase, paDescs[iBest].cb, pszName, 0 /*fFlags*/, NULL);
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /* Update translations. */
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync if ((uint64_t)paDescs[j].off + ((uint32_t)paDescs[j].iFrame << 4) == uBestAddr)
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /* Advance. */
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /* Find next frame. */
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync if (paDescs[j].iFrame >= iFrameMin && paDescs[j].iFrame < iFrame)
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /* Figure the frame span. */
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync uint64_t offThisEnd = paDescs[j].off + paDescs[j].cb;
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /* Add it. */
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync RTStrPrintf(szName, sizeof(szName), "Frame_%04x", iFrame);
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync Log(("CV: %s offEnd=%#x offFirst=%#x\n", szName, offEnd, offFirst));
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync rc = RTDbgModSegmentAdd(pThis->hCnt, (iFrame - iFrameFirst) << 4, offEnd, szName, 0 /*fFlags*/, NULL);
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /* Translation updates. */
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync paDescs[j].cb = offEnd > UINT32_MAX ? UINT32_MAX : (uint32_t)offEnd;
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("RTDbgModCv: %Rrc while adding segments from SegMap\n", rc));
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /* Skip the stuff below if we have DOS frames since we did it all above. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Pass one: Fixate the group segment indexes. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync uint16_t iSeg0 = enmImgFmt == RTLDRFMT_PE || pThis->enmType == RTCVFILETYPE_DBG ? 1 : 0;
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync uint16_t iSeg = iSeg0 + (cbGroup0 > 0); /** @todo probably wrong... */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync else if ((paDescs[i].fFlags & RTCVSEGMAPDESC_F_GROUP) || fNoGroups)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Pass two: Resolve group references in to segment indexes. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync if (!fNoGroups && !(paDescs[i].fFlags & (RTCVSEGMAPDESC_F_GROUP | RTCVSEGMAPDESC_F_ABS)))
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync paDescs[i].iGroup = paDescs[i].iGroup == 0 ? iSeg0 : paDescs[paDescs[i].iGroup].iGroup;
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2((" #%02u: %#010x LB %#010x -> %#06x (flags=%#06x ovl=%#06x frame=%#06x)\n",
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync i, paDescs[i].off, paDescs[i].cb, paDescs[i].iGroup,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync paDescs[i].fFlags, paDescs[i].iOverlay, paDescs[i].iFrame));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Loads the directory into memory (RTDBGMODCV::paDirEnts and
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * RTDBGMODCV::cDirEnts).
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Converting old format version into the newer format to simplifying the code
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * using the directory.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @returns IPRT status code. (May leave with paDirEnts allocated on failure.)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pThis The CV reader instance.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic int rtDbgModCvLoadDirectory(PRTDBGMODCV pThis)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Read in the CV directory.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * 16-bit type.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = rtDbgModCvReadAt(pThis, pThis->offDir, &DirHdr, sizeof(DirHdr));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync if (DirHdr.cEntries > 2 && DirHdr.cEntries < _64K - 32U)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync pThis->paDirEnts = (PRTCVDIRENT32)RTMemAlloc(DirHdr.cEntries * sizeof(pThis->paDirEnts[0]));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = rtDbgModCvReadAt(pThis, pThis->offDir + sizeof(DirHdr),
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync pThis->paDirEnts, DirHdr.cEntries * sizeof(RTCVDIRENT16));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Convert the entries (from the end). */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTCVDIRENT32 volatile *pDst = pThis->paDirEnts + cLeft;
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTCVDIRENT16 volatile *pSrc = (RTCVDIRENT16 volatile *)pThis->paDirEnts + cLeft;
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync pDst->off = RT_MAKE_U32(pSrc->offLow, pSrc->offHigh);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("Old CV directory count is out of considered valid range: %#x\n", DirHdr.cEntries));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * 32-bit type (reading too much for NB04 is no problem).
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = rtDbgModCvReadAt(pThis, pThis->offDir, &DirHdr, sizeof(DirHdr));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("Unexpected CV directory size: %#x\n", DirHdr.Core.cbHdr));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("Extended CV directory headers fields are not zero: fFlags=%#x offNextDir=%#x\n",
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("Unexpected CV directory entry size: %#x (expected %#x)\n", DirHdr.Core.cbEntry, sizeof(RTCVDIRENT32)));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync if (DirHdr.Core.cEntries < 2 || DirHdr.Core.cEntries >= _512K)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("CV directory count is out of considered valid range: %#x\n", DirHdr.Core.cEntries));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync pThis->paDirEnts = (PRTCVDIRENT32)RTMemAlloc(DirHdr.Core.cEntries * sizeof(pThis->paDirEnts[0]));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = rtDbgModCvReadAt(pThis, pThis->offDir + DirHdr.Core.cbHdr,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync pThis->paDirEnts, DirHdr.Core.cEntries * sizeof(RTCVDIRENT32));
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync * Basic info validation and determining the directory ordering.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2(("RTDbgModCv: %u (%#x) directory entries:\n", cDirEnts, cDirEnts));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2((" #%04u mod=%#06x sst=%#06x at %#010x LB %#07x %s\n",
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync i, pDirEnt->iMod, pDirEnt->uSubSectType, pDirEnt->off, pDirEnt->cb,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rtDbgModCvGetSubSectionName(pDirEnt->uSubSectType)));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("CV directory entry #%u is out of bounds: %#x LB %#x, max %#x\n", i, pDirEnt->off, pDirEnt->cb, cbDbgInfo));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("CV directory entry #%u uses module index 0 (uSubSectType=%#x)\n", i, pDirEnt->iMod, pDirEnt->uSubSectType));
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync Log(("CV directory entry #%u: expected module subsection first, found %s (%#x)\n",
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync i, rtDbgModCvGetSubSectionName(pDirEnt->uSubSectType), pDirEnt->uSubSectType));
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync Log(("CV directory entry #%u: skips from mod %#x to %#x modules\n", iModLast, pDirEnt->iMod));
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync Log(("CV directory contains no global modules\n"));
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync Log(("CV dir stats: %u total, %u normal, %u special, iModLast=%#x (%u), enmDirOrder=%d\n",
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync cDirEnts, cNormalMods, cGlobalMods, iModLast, iModLast, pThis->enmDirOrder));
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync * Validate the directory ordering.
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /* Old style with special modules up front. */
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync Log(("CV directory entry #%u: Expected iMod=%x instead of %x\n", i, 0, pThis->paDirEnts[i].iMod));
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /* Normal modules. */
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync uint16_t iEndNormalMods = cNormalMods + (pThis->enmDirOrder == RTCVDIRORDER_BY_MOD_0 ? cGlobalMods : 0);
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync if (pThis->paDirEnts[i].iMod == 0 || pThis->paDirEnts[i].iMod == 0xffff)
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync Log(("CV directory entry #%u: Unexpected global module entry.\n", i));
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync uint32_t fSeen = RT_BIT_32(kCvSst_Module - kCvSst_Module)
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync Log(("CV directory entry #%u: Expected %s (%#x), found %s (%#x).\n",
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync rtDbgModCvGetSubSectionName(pDirEnt->uSubSectType), pDirEnt->uSubSectType));
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync uint32_t iBit = pDirEnt->uSubSectType - kCvSst_Module;
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync Log(("CV directory entry #%u: SST %s (%#x) has already been seen or is for globals.\n",
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync i, rtDbgModCvGetSubSectionName(pDirEnt->uSubSectType), pDirEnt->uSubSectType));
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync /* New style with special modules at the end. */
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync if (pThis->paDirEnts[i].iMod != 0 && pThis->paDirEnts[i].iMod != 0xffff)
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync Log(("CV directory entry #%u: Expected global module entry, not %#x.\n", i,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic int rtDbgModCvLoadCodeViewInfo(PRTDBGMODCV pThis)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Load the directory, the segment map (if any) and then scan for segments
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * if necessary.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = VERR_CV_TODO; /** @todo Scan anything containing address, in particular sstSegMap and sstModule,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * and reconstruct the segments from that information. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Process the directory.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync for (uint32_t i = 0; RT_SUCCESS(rc) && i < pThis->cDirEnts; i++)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log3(("Processing subsection %#u %s\n", i, rtDbgModCvGetSubSectionName(pDirEnt->uSubSectType)));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync pfnCallback = rtDbgModCvSs_GlobalPub_GlobalSym_StaticSym;
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync pfnCallback = rtDbgModCvSs_Symbols_PublicSym_AlignSym;
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** @todo implement more. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Skip because we've already processed them: */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = rtDbgModCvReadAtAlloc(pThis, pDirEnt->off, &pvSubSect, pDirEnt->cb);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = pfnCallback(pThis, pvSubSect, pDirEnt->cb, pDirEnt);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * COFF Debug Info Parsing.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * COFF Debug Info Parsing.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * COFF Debug Info Parsing.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic const char *rtDbgModCvGetCoffStorageClassName(uint8_t bStorageClass)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync case IMAGE_SYM_CLASS_END_OF_FUNCTION: return "END_OF_FUNCTION";
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync case IMAGE_SYM_CLASS_AUTOMATIC: return "AUTOMATIC";
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync case IMAGE_SYM_CLASS_EXTERNAL_DEF: return "EXTERNAL_DEF";
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync case IMAGE_SYM_CLASS_UNDEFINED_LABEL: return "UNDEFINED_LABEL";
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync case IMAGE_SYM_CLASS_MEMBER_OF_STRUCT: return "MEMBER_OF_STRUCT";
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync case IMAGE_SYM_CLASS_STRUCT_TAG: return "STRUCT_TAG";
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync case IMAGE_SYM_CLASS_MEMBER_OF_UNION: return "MEMBER_OF_UNION";
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync case IMAGE_SYM_CLASS_UNION_TAG: return "UNION_TAG";
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync case IMAGE_SYM_CLASS_TYPE_DEFINITION: return "TYPE_DEFINITION";
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync case IMAGE_SYM_CLASS_UNDEFINED_STATIC: return "UNDEFINED_STATIC";
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync case IMAGE_SYM_CLASS_MEMBER_OF_ENUM: return "MEMBER_OF_ENUM";
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync case IMAGE_SYM_CLASS_REGISTER_PARAM: return "REGISTER_PARAM";
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync case IMAGE_SYM_CLASS_BIT_FIELD: return "BIT_FIELD";
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync case IMAGE_SYM_CLASS_FAR_EXTERNAL: return "FAR_EXTERNAL";
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync case IMAGE_SYM_CLASS_END_OF_STRUCT: return "END_OF_STRUCT";
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync case IMAGE_SYM_CLASS_WEAK_EXTERNAL: return "WEAK_EXTERNAL";
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync case IMAGE_SYM_CLASS_CLR_TOKEN: return "CLR_TOKEN";
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTStrPrintf(s_szName, sizeof(s_szName), "Unknown%#04x", bStorageClass);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Adds a chunk of COFF line numbers.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pThis The COFF/CodeView reader instance.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pszFile The source file name.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param iSection The section number.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param paLines Pointer to the first line number table entry.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param cLines The number of line number table entries to add.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic void rtDbgModCvAddCoffLineNumbers(PRTDBGMODCV pThis, const char *pszFile, uint32_t iSection,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log4(("Adding %u line numbers in section #%u for %s\n", cLines, iSection, pszFile));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync while (cLines-- > 0)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync int rc = RTDbgModLineAdd(pThis->hCnt, pszFile, pCur->Linenumber, RTDBGSEGIDX_RVA, pCur->Type.VirtualAddress, NULL);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log4((" %#010x: %u [%Rrc]\n", pCur->Type.VirtualAddress, pCur->Linenumber, rc));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Adds a COFF symbol.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @returns IPRT status (ignored)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pThis The COFF/CodeView reader instance.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param idxSeg IPRT RVA or ABS segment index indicator.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param uValue The symbol value.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pszName The symbol name.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic int rtDbgModCvAddCoffSymbol(PRTDBGMODCV pThis, uint32_t idxSeg, uint32_t uValue, const char *pszName)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync int rc = RTDbgModSymbolAdd(pThis->hCnt, pszName, idxSeg, uValue, 0, 0 /*fFlags*/, NULL);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("Symbol: %s:%08x %s [%Rrc]\n", idxSeg == RTDBGSEGIDX_RVA ? "rva" : "abs", uValue, pszName, rc));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync if (rc == VERR_DBG_ADDRESS_CONFLICT || rc == VERR_DBG_DUPLICATE_SYMBOL)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Processes the COFF symbol table.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @returns IPRT status code
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pThis The COFF/CodeView reader instance.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param paSymbols Pointer to the symbol table.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param cSymbols The number of entries in the symbol table.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param paLines Pointer to the line number table.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param cLines The number of entires in the line number table.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pszzStrTab Pointer to the string table.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param cbStrTab Size of the string table.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic int rtDbgModCvProcessCoffSymbolTable(PRTDBGMODCV pThis,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log3(("Processing COFF symbol table with %#x symbols\n", cSymbols));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Making some bold assumption that the line numbers for the section in
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * the file are allocated sequentially, we do multiple passes until we've
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * gathered them all.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Process the symbols.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync szShort[8] = '\0'; /* avoid having to terminate it all the time. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Copy the symbol in and hope it works around the misalignment
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync issues everywhere. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(Sym.NumberOfAuxSymbols < cSymbols);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Calc a zero terminated symbol name. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync pszName = (const char *)memcpy(szShort, &Sym.N, 8);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(Sym.N.Name.Long < cbStrTab);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Only log stuff and count sections the in the first pass.*/
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log3(("%04x: s=%#06x v=%#010x t=%#06x a=%#04x c=%#04x (%s) name='%s'\n",
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync iSymbol, Sym.SectionNumber, Sym.Value, Sym.Type, Sym.NumberOfAuxSymbols,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Sym.StorageClass, rtDbgModCvGetCoffStorageClassName(Sym.StorageClass), pszName));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync if ((int16_t)cSections <= Sym.SectionNumber && Sym.SectionNumber > 0)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Use storage class to pick what we need (which isn't much because,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * MS only provides a very restricted set of symbols).
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* a NOP */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Change the current file name (for line numbers). Pretend
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync ANSI and ISO-8859-1 are similar enough for out purposes... */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGMODCV_CHECK_NOMSG_RET_BF(Sym.NumberOfAuxSymbols > 0);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync const char *pszFile = (const char *)&paSymbols[iSymbol + 1];
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = RTLatin1ToUtf8Ex(pszFile, Sym.NumberOfAuxSymbols * sizeof(IMAGE_SYMBOL), &pszDst, sizeof(szFile), NULL);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("Error converting COFF filename: %Rrc\n", rc));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync memcpy(&Aux, &paSymbols[iSymbol + 1], sizeof(Aux));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log3((" section: cb=%#010x #relocs=%#06x #lines=%#06x csum=%#x num=%#x sel=%x rvd=%u\n",
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Aux.Section.Length, Aux.Section.NumberOfRelocations,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RT_MAKE_U32(Aux.Section.Number, Aux.Section.HighNumber),
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync uint32_t cLinesToAdd = RT_MIN(Aux.Section.NumberOfLinenumbers, cLines - iLine);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rtDbgModCvAddCoffLineNumbers(pThis, szFile, iLineSect, &paLines[iLine], cLinesToAdd);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Not so sure about the quality here, but might be useful. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rtDbgModCvAddCoffSymbol(pThis, RTDBGSEGIDX_RVA, Sym.Value, pszName);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Add functions (first pass only). */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rtDbgModCvAddCoffSymbol(pThis, RTDBGSEGIDX_ABS, Sym.Value, pszName);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rtDbgModCvAddCoffSymbol(pThis, RTDBGSEGIDX_RVA, Sym.Value, pszName);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Not sure this is really used. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Not used by MS, I think. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("RTDbgCv: Unexpected COFF storage class %#x (%u)\n", Sym.StorageClass, Sym.StorageClass));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* next symbol */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Next section with line numbers. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync } while (iLine < cLines && iLineSect < cSections && RT_SUCCESS(rc));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Loads COFF debug information into the container.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @returns IPRT status code.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pThis The COFF/CodeView debug reader instance.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic int rtDbgModCvLoadCoffInfo(PRTDBGMODCV pThis)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Read the whole section into memory.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Note! Cannot use rtDbgModCvReadAt or rtDbgModCvReadAtAlloc here.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync uint8_t *pbDbgSect = (uint8_t *)RTMemAlloc(pThis->cbCoffDbgInfo);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = pThis->pMod->pImgVt->pfnReadAt(pThis->pMod, UINT32_MAX, pThis->offCoffDbgInfo, pbDbgSect, pThis->cbCoffDbgInfo);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = RTFileReadAt(pThis->hFile, pThis->offCoffDbgInfo, pbDbgSect, pThis->cbCoffDbgInfo, NULL);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* The string table follows after the symbol table. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync + pThis->CoffHdr.NumberOfSymbols * sizeof(IMAGE_SYMBOL));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync uint32_t cbStrTab = (uint32_t)((uintptr_t)(pbDbgSect + pThis->cbCoffDbgInfo) - (uintptr_t)pszzStrTab);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /** @todo The symbol table starts with a size. Read it and checking. Also verify
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * that the symtab ends with a terminator character. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync (PCIMAGE_SYMBOL)(pbDbgSect + pThis->CoffHdr.LvaToFirstSymbol),
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync (PCIMAGE_LINENUMBER)(pbDbgSect + pThis->CoffHdr.LvaToFirstLinenumber),
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * CodeView Debug module implementation.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * CodeView Debug module implementation.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * CodeView Debug module implementation.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @interface_method_impl{RTDBGMODVTDBG,pfnLineByAddr} */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic DECLCALLBACK(int) rtDbgModCv_LineByAddr(PRTDBGMODINT pMod, RTDBGSEGIDX iSeg, RTUINTPTR off,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync return RTDbgModLineByAddr(pThis->hCnt, iSeg, off, poffDisp, pLineInfo);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @interface_method_impl{RTDBGMODVTDBG,pfnLineByOrdinal} */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic DECLCALLBACK(int) rtDbgModCv_LineByOrdinal(PRTDBGMODINT pMod, uint32_t iOrdinal, PRTDBGLINE pLineInfo)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync return RTDbgModLineByOrdinal(pThis->hCnt, iOrdinal, pLineInfo);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @interface_method_impl{RTDBGMODVTDBG,pfnLineCount} */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic DECLCALLBACK(uint32_t) rtDbgModCv_LineCount(PRTDBGMODINT pMod)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @interface_method_impl{RTDBGMODVTDBG,pfnLineAdd} */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic DECLCALLBACK(int) rtDbgModCv_LineAdd(PRTDBGMODINT pMod, const char *pszFile, size_t cchFile, uint32_t uLineNo,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync return RTDbgModLineAdd(pThis->hCnt, pszFile, uLineNo, iSeg, off, piOrdinal);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @interface_method_impl{RTDBGMODVTDBG,pfnSymbolByAddr} */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic DECLCALLBACK(int) rtDbgModCv_SymbolByAddr(PRTDBGMODINT pMod, RTDBGSEGIDX iSeg, RTUINTPTR off, uint32_t fFlags,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync return RTDbgModSymbolByAddr(pThis->hCnt, iSeg, off, fFlags, poffDisp, pSymInfo);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @interface_method_impl{RTDBGMODVTDBG,pfnSymbolByName} */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic DECLCALLBACK(int) rtDbgModCv_SymbolByName(PRTDBGMODINT pMod, const char *pszSymbol, size_t cchSymbol,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync return RTDbgModSymbolByName(pThis->hCnt, pszSymbol/*, cchSymbol*/, pSymInfo);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @interface_method_impl{RTDBGMODVTDBG,pfnSymbolByOrdinal} */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic DECLCALLBACK(int) rtDbgModCv_SymbolByOrdinal(PRTDBGMODINT pMod, uint32_t iOrdinal, PRTDBGSYMBOL pSymInfo)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync return RTDbgModSymbolByOrdinal(pThis->hCnt, iOrdinal, pSymInfo);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @interface_method_impl{RTDBGMODVTDBG,pfnSymbolCount} */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic DECLCALLBACK(uint32_t) rtDbgModCv_SymbolCount(PRTDBGMODINT pMod)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @interface_method_impl{RTDBGMODVTDBG,pfnSymbolAdd} */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic DECLCALLBACK(int) rtDbgModCv_SymbolAdd(PRTDBGMODINT pMod, const char *pszSymbol, size_t cchSymbol,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RTDBGSEGIDX iSeg, RTUINTPTR off, RTUINTPTR cb, uint32_t fFlags,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync return RTDbgModSymbolAdd(pThis->hCnt, pszSymbol, iSeg, off, cb, fFlags, piOrdinal);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @interface_method_impl{RTDBGMODVTDBG,pfnSegmentByIndex} */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic DECLCALLBACK(int) rtDbgModCv_SegmentByIndex(PRTDBGMODINT pMod, RTDBGSEGIDX iSeg, PRTDBGSEGMENT pSegInfo)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync return RTDbgModSegmentByIndex(pThis->hCnt, iSeg, pSegInfo);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @interface_method_impl{RTDBGMODVTDBG,pfnSegmentCount} */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic DECLCALLBACK(RTDBGSEGIDX) rtDbgModCv_SegmentCount(PRTDBGMODINT pMod)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @interface_method_impl{RTDBGMODVTDBG,pfnSegmentAdd} */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic DECLCALLBACK(int) rtDbgModCv_SegmentAdd(PRTDBGMODINT pMod, RTUINTPTR uRva, RTUINTPTR cb, const char *pszName, size_t cchName,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync return RTDbgModSegmentAdd(pThis->hCnt, uRva, cb, pszName, fFlags, piSeg);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @interface_method_impl{RTDBGMODVTDBG,pfnImageSize} */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic DECLCALLBACK(RTUINTPTR) rtDbgModCv_ImageSize(PRTDBGMODINT pMod)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @interface_method_impl{RTDBGMODVTDBG,pfnRvaToSegOff} */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic DECLCALLBACK(RTDBGSEGIDX) rtDbgModCv_RvaToSegOff(PRTDBGMODINT pMod, RTUINTPTR uRva, PRTUINTPTR poffSeg)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync return RTDbgModRvaToSegOff(pThis->hCnt, uRva, poffSeg);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @interface_method_impl{RTDBGMODVTDBG,pfnClose} */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic DECLCALLBACK(int) rtDbgModCv_Close(PRTDBGMODINT pMod)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Probing code used by rtDbgModCv_TryOpen.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Probing code used by rtDbgModCv_TryOpen.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @callback_method_impl{FNRTLDRENUMSEGS,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Used to add segments from the image.} */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic DECLCALLBACK(int) rtDbgModCvAddSegmentsCallback(RTLDRMOD hLdrMod, PCRTLDRSEG pSeg, void *pvUser)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("Segment %s: LinkAddress=%#llx RVA=%#llx cb=%#llx\n",
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync pSeg->pszName, (uint64_t)pSeg->LinkAddress, (uint64_t)pSeg->RVA, pSeg->cb));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* If the segment doesn't have a mapping, just add a dummy so the indexing
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync works out correctly (same as for the image). */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync return RTDbgModSegmentAdd(pThis->hCnt, 0, 0, pSeg->pszName, 0 /*fFlags*/, NULL);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync return RTDbgModSegmentAdd(pThis->hCnt, pSeg->RVA, cb, pSeg->pszName, 0 /*fFlags*/, NULL);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Copies the sections over from the DBG file.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Called if we don't have an associated executable image.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @returns IPRT status code.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pThis The CV module instance.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pDbgHdr The DBG file header.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pszFilename The filename (for logging).
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic int rtDbgModCvAddSegmentsFromDbg(PRTDBGMODCV pThis, PCIMAGE_SEPARATE_DEBUG_HEADER pDbgHdr, const char *pszFilename)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Validate the header fields a little.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("RTDbgModCv: Bad NumberOfSections: %d\n", pDbgHdr->NumberOfSections));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync if (!RT_IS_POWER_OF_TWO(pDbgHdr->SectionAlignment))
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("RTDbgModCv: Bad SectionAlignment: %#x\n", pDbgHdr->SectionAlignment));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Read the section table.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync size_t cbShs = pDbgHdr->NumberOfSections * sizeof(IMAGE_SECTION_HEADER);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync PIMAGE_SECTION_HEADER paShs = (PIMAGE_SECTION_HEADER)RTMemAlloc(cbShs);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync int rc = RTFileReadAt(pThis->hFile, sizeof(*pDbgHdr), paShs, cbShs, NULL);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Do some basic validation.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync for (uint32_t i = 0; i < pDbgHdr->NumberOfSections; i++)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log3(("RTDbgModCv: Section #%02u %#010x LB %#010x %.*s\n",
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync i, paShs[i].VirtualAddress, paShs[i].Misc.VirtualSize, sizeof(paShs[i].Name), paShs[i].Name));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync if (paShs[i].Characteristics & IMAGE_SCN_TYPE_NOLOAD)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("RTDbgModCv: %s: Overlap or soring error, VirtualAddress=%#x uRvaPrev=%#x - section #%d '%.*s'!!!\n",
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync pszFilename, paShs[i].VirtualAddress, uRvaPrev, i, sizeof(paShs[i].Name), paShs[i].Name));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync else if ( paShs[i].VirtualAddress > pDbgHdr->SizeOfImage
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync || paShs[i].Misc.VirtualSize > pDbgHdr->SizeOfImage
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync || paShs[i].VirtualAddress + paShs[i].Misc.VirtualSize > pDbgHdr->SizeOfImage)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("RTDbgModCv: %s: VirtualAddress=%#x VirtualSize=%#x (total %x) - beyond image size (%#x) - section #%d '%.*s'!!!\n",
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync pszFilename, paShs[i].VirtualAddress, paShs[i].Misc.VirtualSize,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync paShs[i].VirtualAddress + paShs[i].Misc.VirtualSize,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync pThis->cbImage, i, sizeof(paShs[i].Name), paShs[i].Name));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync else if (paShs[i].VirtualAddress & (pDbgHdr->SectionAlignment - 1))
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("RTDbgModCv: %s: VirtualAddress=%#x misaligned (%#x) - section #%d '%.*s'!!!\n",
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync pszFilename, paShs[i].VirtualAddress, pDbgHdr->SectionAlignment, i, sizeof(paShs[i].Name), paShs[i].Name));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync uRvaPrev = paShs[i].VirtualAddress + paShs[i].Misc.VirtualSize;
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("RTDbgModCv: %s: No loadable sections.\n", pszFilename));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("RTDbgModCv: %s: No space for PE headers.\n", pszFilename));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Add sections.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = RTDbgModSegmentAdd(pThis->hCnt, 0, cbHeaders, "NtHdrs", 0 /*fFlags*/, NULL);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync for (uint32_t i = 0; RT_SUCCESS(rc) && i < pDbgHdr->NumberOfSections; i++)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync memcpy(szName, paShs[i].Name, sizeof(paShs[i].Name));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync if (paShs[i].Characteristics & IMAGE_SCN_TYPE_NOLOAD)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = RTDbgModSegmentAdd(pThis->hCnt, 0, 0, szName, 0 /*fFlags*/, NULL);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = RTDbgModSegmentAdd(pThis->hCnt, paShs[i].VirtualAddress, paShs[i].Misc.VirtualSize, szName,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Instantiates the CV/COFF reader.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @returns IPRT status code
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pDbgMod The debug module instance.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param enmFileType The type of input file.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param hFile The file handle, NIL_RTFILE of image.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param ppThis Where to return the reader instance.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic int rtDbgModCvCreateInstance(PRTDBGMODINT pDbgMod, RTCVFILETYPE enmFileType, RTFILE hFile, PRTDBGMODCV *ppThis)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Do we already have an instance? Happens if we find multiple debug
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * formats we support.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync PRTDBGMODCV pThis = (PRTDBGMODCV)pDbgMod->pvDbgPriv;
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Create a new instance.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync pThis = (PRTDBGMODCV)RTMemAllocZ(sizeof(RTDBGMODCV));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync int rc = RTDbgModCreate(&pThis->hCnt, pDbgMod->pszName, 0 /*cbSeg*/, 0 /*fFlags*/);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Common part of the COFF probing.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @returns status code.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pDbgMod The debug module instance. On success pvDbgPriv
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * will point to a valid RTDBGMODCV.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param hFile The file with debug info in it.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param off The offset where to expect CV debug info.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param cb The number of bytes of debug info.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param enmArch The desired image architecture.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pszFilename The path to the file (for logging).
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic int rtDbgModCvProbeCoff(PRTDBGMODINT pDbgMod, RTCVFILETYPE enmFileType, RTFILE hFile,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync uint32_t off, uint32_t cb, const char *pszFilename)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Check that there is sufficient data for a header, then read it.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("RTDbgModCv: Not enough room for COFF header.\n"));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("RTDbgModCv: COFF debug information is to large (%'u bytes), max is 128MB\n", cb));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = pDbgMod->pImgVt->pfnReadAt(pDbgMod, UINT32_MAX, off, &Hdr, sizeof(Hdr));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = RTFileReadAt(hFile, off, &Hdr, sizeof(Hdr), NULL);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("RTDbgModCv: Error reading COFF header: %Rrc\n", rc));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2(("RTDbgModCv: Found COFF debug info header at %#x (LB %#x) in %s\n", off, cb, pszFilename));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2((" NumberOfSymbols = %#010x\n", Hdr.NumberOfSymbols));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2((" LvaToFirstSymbol = %#010x\n", Hdr.LvaToFirstSymbol));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2((" NumberOfLinenumbers = %#010x\n", Hdr.NumberOfLinenumbers));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2((" LvaToFirstLinenumber = %#010x\n", Hdr.LvaToFirstLinenumber));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2((" RvaToFirstByteOfCode = %#010x\n", Hdr.RvaToFirstByteOfCode));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2((" RvaToLastByteOfCode = %#010x\n", Hdr.RvaToLastByteOfCode));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2((" RvaToFirstByteOfData = %#010x\n", Hdr.RvaToFirstByteOfData));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2((" RvaToLastByteOfData = %#010x\n", Hdr.RvaToLastByteOfData));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Validate the COFF header.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync if ( (uint64_t)Hdr.LvaToFirstSymbol + (uint64_t)Hdr.NumberOfSymbols * sizeof(IMAGE_SYMBOL) > cb
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync || (Hdr.LvaToFirstSymbol < sizeof(Hdr) && Hdr.NumberOfSymbols > 0))
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("RTDbgModCv: Bad COFF symbol count or/and offset: LvaToFirstSymbol=%#x, NumberOfSymbols=%#x cbCoff=%#x\n",
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync if ( (uint64_t)Hdr.LvaToFirstLinenumber + (uint64_t)Hdr.NumberOfLinenumbers * sizeof(IMAGE_LINENUMBER) > cb
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync || (Hdr.LvaToFirstLinenumber < sizeof(Hdr) && Hdr.NumberOfLinenumbers > 0))
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("RTDbgModCv: Bad COFF symbol count or/and offset: LvaToFirstSymbol=%#x, NumberOfSymbols=%#x cbCoff=%#x\n",
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("RTDbgModCv: The COFF symbol table is too short to be of any worth... (%u syms)\n", Hdr.NumberOfSymbols));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * What we care about looks fine, use it.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = rtDbgModCvCreateInstance(pDbgMod, enmFileType, hFile, &pThis);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Common part of the CodeView probing.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @returns status code.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pDbgMod The debug module instance. On success pvDbgPriv
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * will point to a valid RTDBGMODCV.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pCvHdr The CodeView base header.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param enmFileType The kind of file this is we're probing.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param hFile The file with debug info in it.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param off The offset where to expect CV debug info.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param cb The number of bytes of debug info.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pszFilename The path to the file (for logging).
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic int rtDbgModCvProbeCommon(PRTDBGMODINT pDbgMod, PRTCVHDR pCvHdr, RTCVFILETYPE enmFileType, RTFILE hFile,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync uint32_t off, uint32_t cb, RTLDRARCH enmArch, const char *pszFilename)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Is a codeview format we (wish to) support? */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* We're assuming it's a base header, so the offset must be within
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync the area defined by the debug info we got from the loader. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync if (pCvHdr->off < cb && pCvHdr->off >= sizeof(*pCvHdr))
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("RTDbgModCv: Found %c%c%c%c at %#RTfoff - size %#x, directory at %#x. file type %d\n",
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync RT_BYTE1(pCvHdr->u32Magic), RT_BYTE2(pCvHdr->u32Magic), RT_BYTE3(pCvHdr->u32Magic), RT_BYTE4(pCvHdr->u32Magic),
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Create a module instance, if not already done.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = rtDbgModCvCreateInstance(pDbgMod, enmFileType, hFile, &pThis);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @callback_method_impl{FNRTLDRENUMDBG} */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic DECLCALLBACK(int) rtDbgModCvEnumCallback(RTLDRMOD hLdrMod, PCRTLDRDBGINFO pDbgInfo, void *pvUser)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Skip external files, RTDbgMod will deal with those
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync via RTDBGMODINT::pszDbgFile. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* We only handle the codeview sections. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync if (pDbgInfo->enmType == RTLDRDBGINFOTYPE_CODEVIEW)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Read the specified header and check if we like it. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync int rc = pDbgMod->pImgVt->pfnReadAt(pDbgMod, pDbgInfo->iDbgInfo, pDbgInfo->offFile, &CvHdr, sizeof(CvHdr));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = rtDbgModCvProbeCommon(pDbgMod, &CvHdr, RTCVFILETYPE_IMAGE, NIL_RTFILE, pDbgInfo->offFile, pDbgInfo->cb,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync pDbgMod->pImgVt->pfnGetArch(pDbgMod), pDbgMod->pszImgFile);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync else if (pDbgInfo->enmType == RTLDRDBGINFOTYPE_COFF)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Join paths with the DBG code. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rtDbgModCvProbeCoff(pDbgMod, RTCVFILETYPE_IMAGE, NIL_RTFILE, pDbgInfo->offFile, pDbgInfo->cb, pDbgMod->pszImgFile);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Part two of the external file probing.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @returns status code.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pDbgMod The debug module instance. On success pvDbgPriv
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * will point to a valid RTDBGMODCV.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param enmFileType The kind of file this is we're probing.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param hFile The file with debug info in it.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param off The offset where to expect CV debug info.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param cb The number of bytes of debug info.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param enmArch The desired image architecture.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pszFilename The path to the file (for logging).
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic int rtDbgModCvProbeFile2(PRTDBGMODINT pThis, RTCVFILETYPE enmFileType, RTFILE hFile, uint32_t off, uint32_t cb,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync int rc = RTFileReadAt(hFile, off, &CvHdr, sizeof(CvHdr), NULL);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = rtDbgModCvProbeCommon(pThis, &CvHdr, enmFileType, hFile, off, cb, enmArch, pszFilename);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Probes an external file for CodeView information.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @returns status code.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pDbgMod The debug module instance. On success pvDbgPriv
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * will point to a valid RTDBGMODCV.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param pszFilename The path to the file to probe.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * @param enmArch The desired image architecture.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic int rtDbgModCvProbeFile(PRTDBGMODINT pDbgMod, const char *pszFilename, RTLDRARCH enmArch)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync int rc = RTFileOpen(&hFile, pszFilename, RTFILE_O_READ | RTFILE_O_DENY_WRITE | RTFILE_O_OPEN);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Check for .DBG file
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = RTFileReadAt(hFile, 0, &DbgHdr, sizeof(DbgHdr), NULL);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync && DbgHdr.Signature == IMAGE_SEPARATE_DEBUG_SIGNATURE)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2(("RTDbgModCv: Found separate debug header in %s:\n", pszFilename));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2((" Characteristics = %#x\n", DbgHdr.Characteristics));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2((" TimeDateStamp = %#x\n", DbgHdr.TimeDateStamp));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2((" SizeOfImage = %#x\n", DbgHdr.SizeOfImage));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2((" NumberOfSections = %#x\n", DbgHdr.NumberOfSections));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2((" ExportedNamesSize = %#x\n", DbgHdr.ExportedNamesSize));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2((" DebugDirectorySize = %#x\n", DbgHdr.DebugDirectorySize));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log2((" SectionAlignment = %#x\n", DbgHdr.SectionAlignment));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Match up the architecture if specified.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Probe for readable debug info in the debug directory.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync + DbgHdr.NumberOfSections * sizeof(IMAGE_SECTION_HEADER)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync uint32_t cEntries = DbgHdr.DebugDirectorySize / sizeof(IMAGE_DEBUG_DIRECTORY);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync for (uint32_t i = 0; i < cEntries; i++, offDbgDir += sizeof(IMAGE_DEBUG_DIRECTORY))
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = RTFileReadAt(hFile, offDbgDir, &DbgDir, sizeof(DbgDir), NULL);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = rtDbgModCvProbeFile2(pDbgMod, RTCVFILETYPE_DBG, hFile,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = rtDbgModCvProbeCoff(pDbgMod, RTCVFILETYPE_DBG, hFile,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync DbgDir.PointerToRawData, DbgDir.SizeOfData, pszFilename);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * If we get down here with an instance, it prooves that we've found
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * something, regardless of any errors. Add the sections and such.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync PRTDBGMODCV pThis = (PRTDBGMODCV)pDbgMod->pvDbgPriv;
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = rtDbgModCvAddSegmentsFromDbg(pThis, &DbgHdr, pszFilename);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Failed to find CV or smth, look at the end of the file just to be sure... */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Look for CV tail header.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = RTFileSeek(hFile, -(RTFOFF)sizeof(RTCVHDR), RTFILE_SEEK_END, &cbFile);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = RTFileRead(hFile, &CvHdr, sizeof(CvHdr), NULL);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = rtDbgModCvProbeFile2(pDbgMod, RTCVFILETYPE_OTHER_AT_END, hFile,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync cbFile - CvHdr.off, CvHdr.off, enmArch, pszFilename);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** @interface_method_impl{RTDBGMODVTDBG,pfnTryOpen} */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncstatic DECLCALLBACK(int) rtDbgModCv_TryOpen(PRTDBGMODINT pMod, RTLDRARCH enmArch)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Look for debug info.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = rtDbgModCvProbeFile(pMod, pMod->pszDbgFile, enmArch);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync int rc2 = pMod->pImgVt->pfnEnumDbgInfo(pMod, rtDbgModCvEnumCallback, pMod);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /* Try the executable in case it has a NBxx tail header. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc2 = rtDbgModCvProbeFile(pMod, pMod->pszImgFile, enmArch);
5b10512d37abdd57501678491734e6fe77c7957bvboxsync if (RT_FAILURE(rc2) && (RT_SUCCESS(rc) || rc == VERR_DBG_NO_MATCHING_INTERPRETER))
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync return RT_SUCCESS_NP(rc) ? VERR_DBG_NO_MATCHING_INTERPRETER : rc;
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync Assert(pThis->offBase != UINT32_MAX || pThis->offCoffDbgInfo != UINT32_MAX);
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync * Load the debug info.
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync rc = pMod->pImgVt->pfnEnumSegments(pMod, rtDbgModCvAddSegmentsCallback, pThis);
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync if (RT_SUCCESS(rc) && pThis->offBase != UINT32_MAX)
4816ffbeaf6b2644234e30f2de2854a85671505bvboxsync if (RT_SUCCESS(rc) && pThis->offCoffDbgInfo != UINT32_MAX)
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("RTDbgCv: Successfully loaded debug info\n"));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync Log(("RTDbgCv: Debug info load error %Rrc\n", rc));
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync/** Virtual function table for the CodeView debug info reader. */
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsyncDECL_HIDDEN_CONST(RTDBGMODVTDBG) const g_rtDbgModVtDbgCodeView =
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /*.pfnSegmentByIndex = */ rtDbgModCv_SegmentByIndex,
44f4668fd6b017b6d71e83a53d771d67f5e00ab7vboxsync /*.pfnSymbolByOrdinal = */ rtDbgModCv_SymbolByOrdinal,