dbgas.cpp revision 044af0d1e6474076366759db86f101778c5f20cc
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * IPRT - Debug Address Space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Copyright (C) 2009 Sun Microsystems, Inc.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * available from http://www.virtualbox.org. This file is free software;
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * you can redistribute it and/or modify it under the terms of the GNU
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * General Public License (GPL) as published by the Free Software
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * The contents of this file may alternatively be used under the terms
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * of the Common Development and Distribution License Version 1.0
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * VirtualBox OSE distribution, in which case the provisions of the
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * CDDL are applicable instead of those of the GPL.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * You may elect to license modified versions of this file under the
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * terms and conditions of either the GPL or the CDDL or both.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Clara, CA 95054 USA or visit http://www.sun.com if you need
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * additional information or have any questions.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync/*******************************************************************************
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync* Header Files *
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync*******************************************************************************/
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync/*******************************************************************************
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync* Structures and Typedefs *
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync*******************************************************************************/
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync/** Pointer to a module table entry. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync/** Pointer to an address space mapping node. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync/** Pointer to a name head. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Module entry.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsynctypedef struct RTDBGASMOD
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Node core, the module handle is the key. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Pointer to the first mapping of the module or a segment within it. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Pointer to the next module with an identical name. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * An address space mapping, either of a full module or a segment.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsynctypedef struct RTDBGASMAP
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** The AVL node core. Contains the address range. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Pointer to the next mapping of the module. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Pointer to the module. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Which segment in the module.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * This is NIL_RTDBGSEGIDX when the entire module is mapped. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Name in the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsynctypedef struct RTDBGASNAME
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** The string space node core.*/
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** The list of nodes */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Debug address space instance.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsynctypedef struct RTDBGASINT
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Magic value (RTDBGAS_MAGIC). */
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync /** The number of reference to this address space. */
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync /** Handle of the read-write lock. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Number of modules in the module address space. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Pointer to the module table.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * The valid array length is given by cModules. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** AVL tree translating module handles to module entries. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** AVL tree mapping addresses to modules. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Names of the modules in the name space. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** The first address the AS. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** The last address in the AS. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** The name of the address space. (variable length) */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync/** Pointer to an a debug address space instance. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync/*******************************************************************************
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync* Defined Constants And Macros *
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync*******************************************************************************/
172ae196da38208e5f1e3485715a89f2d53c6880vboxsync/** Validates an address space handle and returns rc if not valid. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync AssertReturn((pDbgAs)->u32Magic == RTDBGAS_MAGIC, (rc)); \
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync } while (0)
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync/** Locks the address space for reading. */
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync int rcLock = RTSemRWRequestRead((pDbgAs)->hLock, RT_INDEFINITE_WAIT); \
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync } while (0)
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync/** Unlocks the address space after reading. */
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync int rcLock = RTSemRWReleaseRead((pDbgAs)->hLock); \
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync } while (0)
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync/** Locks the address space for writing. */
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync int rcLock = RTSemRWRequestWrite((pDbgAs)->hLock, RT_INDEFINITE_WAIT); \
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync } while (0)
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync/** Unlocks the address space after writing. */
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync int rcLock = RTSemRWReleaseWrite((pDbgAs)->hLock); \
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync } while (0)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync/*******************************************************************************
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync* Internal Functions *
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync*******************************************************************************/
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncstatic void rtDbgAsModuleUnlinkMod(PRTDBGASINT pDbgAs, PRTDBGASMOD pMod);
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsyncstatic void rtDbgAsModuleUnlinkByMap(PRTDBGASINT pDbgAs, PRTDBGASMAP pMap);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Creates an empty address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param phDbgAs Where to store the address space handle on success.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param FirstAddr The first address in the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param LastAddr The last address in the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pszName The name of the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsCreate(PRTDBGAS phDbgAs, RTUINTPTR FirstAddr, RTUINTPTR LastAddr, const char *pszName)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Input validation.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync AssertReturn(FirstAddr < LastAddr, VERR_INVALID_PARAMETER);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Allocate memory for the instance data.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASINT pDbgAs = (PRTDBGASINT)RTMemAlloc(RT_OFFSETOF(RTDBGASINT, szName[cchName + 1]));
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /* initalize it. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Variant of RTDbgAsCreate that takes a name format string.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param phDbgAs Where to store the address space handle on success.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param FirstAddr The first address in the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param LastAddr The last address in the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pszNameFmt The name format of the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param va Format arguments.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsCreateV(PRTDBGAS phDbgAs, RTUINTPTR FirstAddr, RTUINTPTR LastAddr, const char *pszNameFmt, va_list va)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync int rc = RTDbgAsCreate(phDbgAs, FirstAddr, LastAddr, pszName);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Variant of RTDbgAsCreate that takes a name format string.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param phDbgAs Where to store the address space handle on success.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param FirstAddr The first address in the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param LastAddr The last address in the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pszNameFmt The name format of the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param ... Format arguments.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsCreateF(PRTDBGAS phDbgAs, RTUINTPTR FirstAddr, RTUINTPTR LastAddr, const char *pszNameFmt, ...)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync int rc = RTDbgAsCreateV(phDbgAs, FirstAddr, LastAddr, pszNameFmt, va);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Callback used by RTDbgAsDestroy to free all mapping nodes.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns 0
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pNode The map node.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pvUser NULL.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncstatic DECLCALLBACK(int) rtDbgAsDestroyMapCallback(PAVLRUINTPTRNODECORE pNode, void *pvUser)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Callback used by RTDbgAsDestroy to free all name space nodes.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns 0
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pStr The name node.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pvUser NULL.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncstatic DECLCALLBACK(int) rtDbgAsDestroyNameCallback(PRTSTRSPACECORE pStr, void *pvUser)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Destroys the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * This means unlinking all the modules it currently contains, potentially
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * causing some or all of them to be destroyed as they are managed by
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * reference counting.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param pDbgAs The address space instance to be destroyed.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Mark the address space invalid and release all the modules.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync ASMAtomicWriteU32(&pDbgAs->u32Magic, ~RTDBGAS_MAGIC);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTAvlrUIntPtrDestroy(&pDbgAs->MapTree, rtDbgAsDestroyMapCallback, NULL);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTStrSpaceDestroy(&pDbgAs->NameSpace, rtDbgAsDestroyNameCallback, NULL);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync while (i-- > 0)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDbgModRelease((RTDBGMOD)pDbgAs->paModules[i].Core.Key);
172ae196da38208e5f1e3485715a89f2d53c6880vboxsync * Retains another reference to the address space.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @returns New reference count, UINT32_MAX on invalid handle (asserted).
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param hDbgAs The address space handle.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @remarks Will not take any locks.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Release a reference to the address space.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * When the reference count reaches zero, the address space is destroyed.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * That means unlinking all the modules it currently contains, potentially
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * causing some or all of them to be destroyed as they are managed by
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * reference counting.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @returns New reference count, UINT32_MAX on invalid handle (asserted).
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param hDbgAs The address space handle. The NIL handle is quietly
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * ignored and 0 is returned.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @remarks Will not take any locks.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Gets the name of an address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns read only address space name.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * NULL if hDbgAs is invalid.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @remarks Will not take any locks.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Gets the first address in an address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns The address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * 0 if hDbgAs is invalid.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @remarks Will not take any locks.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Gets the last address in an address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns The address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * 0 if hDbgAs is invalid.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @remarks Will not take any locks.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Gets the number of modules in the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * This can be used together with RTDbgAsModuleByIndex
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * to enumerate the modules.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns The number of modules.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @remarks Will not take any locks.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Common worker for RTDbgAsModuleLink and RTDbgAsModuleLinkSeg.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pDbgAs Pointer to the address space instance data.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgMod The module to link.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param iSeg The segment to link or NIL if all.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param Addr The address we're linking it at.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param cb The size of what we're linking.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pszName The name of the module.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param fFlags See RTDBGASLINK_FLAGS_*.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @remarks The caller must have locked the address space for writing.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncint rtDbgAsModuleLinkCommon(PRTDBGASINT pDbgAs, RTDBGMOD hDbgMod, RTDBGSEGIDX iSeg,
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync RTUINTPTR Addr, RTUINTPTR cb, const char *pszName, uint32_t fFlags)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Check that the requested space is undisputed.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync PRTDBGASMAP pAdjMod = (PRTDBGASMAP)RTAvlrUIntPtrGetBestFit(&pDbgAs->MapTree, Addr, false /* fAbove */);
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync pAdjMod = (PRTDBGASMAP)RTAvlrUIntPtrGetBestFit(&pDbgAs->MapTree, Addr, true /* fAbove */);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * First, create or find the module table entry.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASMOD pMod = (PRTDBGASMOD)RTAvlPVGet(&pDbgAs->ModTree, hDbgMod);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Ok, we need a new entry. Grow the table if necessary.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync void *pvNew = RTMemRealloc(pDbgAs->paModules, sizeof(pDbgAs->paModules[0]) * (pDbgAs->cModules + 32));
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Add it to the name space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASNAME pName = (PRTDBGASNAME)RTStrSpaceGet(&pDbgAs->NameSpace, pszName);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync pName = (PRTDBGASNAME)RTMemAlloc(sizeof(*pName) + cchName + 1);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync pName->StrCore.pszString = (char *)memcpy(pName + 1, pszName, cchName + 1);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /* quick, but unfair. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Create a mapping node.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASMAP pMap = (PRTDBGASMAP)RTMemAlloc(sizeof(*pMap));
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync if (RTAvlrUIntPtrInsert(&pDbgAs->MapTree, &pMap->Core))
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Unlink the module if this was the only mapping.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Links a module into the address space at the give address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * The size of the mapping is determined using RTDbgModImageSize().
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_OUT_OF_RANGE if the specified address will put the module
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * outside the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_ADDRESS_CONFLICT if the mapping clashes with existing mappings.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgMod The module handle of the module to be linked in.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param ImageAddr The address to link the module at.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param fFlags See RTDBGASLINK_FLAGS_*.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsyncRTDECL(int) RTDbgAsModuleLink(RTDBGAS hDbgAs, RTDBGMOD hDbgMod, RTUINTPTR ImageAddr, uint32_t fFlags)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync AssertReturn(!(fFlags & ~RTDBGASLINK_FLAGS_VALID_MASK), VERR_INVALID_PARAMETER);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Invoke worker common with RTDbgAsModuleLinkSeg.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync int rc = rtDbgAsModuleLinkCommon(pDbgAs, hDbgMod, NIL_RTDBGSEGIDX, ImageAddr, cb, pszName, fFlags);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Links a segment into the address space at the give address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * The size of the mapping is determined using RTDbgModSegmentSize().
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_OUT_OF_RANGE if the specified address will put the module
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * outside the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_ADDRESS_CONFLICT if the mapping clashes with existing mappings.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgMod The module handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param iSeg The segment number (0-based) of the segment to be
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * linked in.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param SegAddr The address to link the segment at.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param fFlags See RTDBGASLINK_FLAGS_*.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsyncRTDECL(int) RTDbgAsModuleLinkSeg(RTDBGAS hDbgAs, RTDBGMOD hDbgMod, RTDBGSEGIDX iSeg, RTUINTPTR SegAddr, uint32_t fFlags)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync AssertReturn(!(fFlags & ~RTDBGASLINK_FLAGS_VALID_MASK), VERR_INVALID_PARAMETER);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Invoke worker common with RTDbgAsModuleLinkSeg.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync int rc = rtDbgAsModuleLinkCommon(pDbgAs, hDbgMod, iSeg, SegAddr, cb, pszName, fFlags);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Worker for RTDbgAsModuleUnlink, RTDbgAsModuleUnlinkByAddr and rtDbgAsModuleLinkCommon.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pDbgAs Pointer to the address space instance data.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pMod The module to unlink.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @remarks The caller must have locked the address space for writing.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncstatic void rtDbgAsModuleUnlinkMod(PRTDBGASINT pDbgAs, PRTDBGASMOD pMod)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Unlink it from the name.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASNAME pName = (PRTDBGASNAME)RTStrSpaceGet(&pDbgAs->NameSpace, RTDbgModName((RTDBGMOD)pMod->Core.Key));
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync for (PRTDBGASMOD pCur = pName->pHead; pCur; pCur = pCur->pNextName)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Free the name if this was the last reference to it.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync pName = (PRTDBGASNAME)RTStrSpaceRemove(&pDbgAs->NameSpace, pName->StrCore.pszString);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Remove it from the module handle tree.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PAVLPVNODECORE pNode = RTAvlPVRemove(&pDbgAs->ModTree, pMod->Core.Key);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Remove it from the module table by replacing it by the last entry.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync pDbgAs->paModules[iMod] = pDbgAs->paModules[pDbgAs->cModules];
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Worker for RTDbgAsModuleUnlink and RTDbgAsModuleUnlinkByAddr.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pDbgAs Pointer to the address space instance data.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pMap The map to unlink and free.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @remarks The caller must have locked the address space for writing.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncstatic void rtDbgAsModuleUnlinkMap(PRTDBGASINT pDbgAs, PRTDBGASMAP pMap)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /* remove from the tree */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PAVLRUINTPTRNODECORE pNode = RTAvlrUIntPtrRemove(&pDbgAs->MapTree, pMap->Core.Key);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /* unlink */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync bool fFound = false;
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync for (PRTDBGASMAP pCur = pMod->pMapHead; pCur; pCur = pCur->pNext)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /* free it */
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Worker for RTDbgAsModuleUnlinkByAddr and rtDbgAsModuleLinkCommon that
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * unlinks a single mapping and releases the module if it's the last one.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param pDbgAs The address space instance.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param pMap The mapping to unlink.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @remarks The caller must have locked the address space for writing.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsyncstatic void rtDbgAsModuleUnlinkByMap(PRTDBGASINT pDbgAs, PRTDBGASMAP pMap)
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Unlink it from the address space.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Unlink the module as well if it's the last mapping it has.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Unlinks all the mappings of a module from the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_NOT_FOUND if the module wasn't found.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgMod The module handle of the module to be unlinked.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsModuleUnlink(RTDBGAS hDbgAs, RTDBGMOD hDbgMod)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASMOD pMod = (PRTDBGASMOD)RTAvlPVGet(&pDbgAs->ModTree, hDbgMod);
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Unmap all everything and release the module.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Unlinks the mapping at the specified address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_NOT_FOUND if no module or segment is mapped at that address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param Addr The address within the mapping to be unlinked.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsModuleUnlinkByAddr(RTDBGAS hDbgAs, RTUINTPTR Addr)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASMAP pMap = (PRTDBGASMAP)RTAvlrUIntPtrRangeGet(&pDbgAs->MapTree, Addr);
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Hand it to
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Get a the handle of a module in the address space by is index.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns A retained handle to the specified module. The caller must release
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * the returned reference.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * NIL_RTDBGMOD if invalid index or handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param iModule The index of the module to get.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @remarks The module indexes may change after calls to RTDbgAsModuleLink,
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * RTDbgAsModuleLinkSeg, RTDbgAsModuleUnlink and
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * RTDbgAsModuleUnlinkByAddr.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(RTDBGMOD) RTDbgAsModuleByIndex(RTDBGAS hDbgAs, uint32_t iModule)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Get, retain and return it.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGMOD hMod = (RTDBGMOD)pDbgAs->paModules[iModule].Core.Key;
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Queries mapping module information by handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_NOT_FOUND if no mapping was found at the specified address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param Addr Address within the mapping of the module or segment.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param phMod Where to the return the retained module handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Optional.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pAddr Where to return the base address of the mapping.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Optional.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param piSeg Where to return the segment index. This is set to
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * NIL if the entire module is mapped as a single
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * mapping. Optional.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsModuleByAddr(RTDBGAS hDbgAs, RTUINTPTR Addr, PRTDBGMOD phMod, PRTUINTPTR pAddr, PRTDBGSEGIDX piSeg)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASMAP pMap = (PRTDBGASMAP)RTAvlrUIntPtrRangeGet(&pDbgAs->MapTree, Addr);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Set up the return values.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Queries mapping module information by name.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_NOT_FOUND if no mapping was found at the specified address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_OUT_OF_RANGE if the name index was out of range.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pszName The module name.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param iName There can be more than one module by the same name
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * in an address space. This argument indicates which
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * is ment. (0 based)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param phMod Where to the return the retained module handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsModuleByName(RTDBGAS hDbgAs, const char *pszName, uint32_t iName, PRTDBGMOD phMod)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASNAME pName = (PRTDBGASNAME)RTStrSpaceGet(&pDbgAs->NameSpace, pszName);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync while (iName-- > 0)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Get, retain and return it.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Internal worker that looks up and retains a module.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @returns Module handle, NIL_RTDBGMOD if not found.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param pDbgAs The address space instance data.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param Addr Address within the module.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param piSeg where to return the segment index.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param poffSeg Where to return the segment offset.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param pMapAddr The mapping address (RTDBGASMAP::Core.Key).
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsyncDECLINLINE(RTDBGMOD) rtDbgAsModuleByAddr(PRTDBGASINT pDbgAs, RTUINTPTR Addr, PRTDBGSEGIDX piSeg, PRTUINTPTR poffSeg, PRTUINTPTR pMapAddr)
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync PRTDBGASMAP pMap = (PRTDBGASMAP)RTAvlrUIntPtrRangeGet(&pDbgAs->MapTree, Addr);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync *piSeg = pMap->iSeg != NIL_RTDBGSEGIDX ? pMap->iSeg : RTDBGSEGIDX_RVA;
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * Adjusts the address to correspond to the mapping of the module/segment.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param pSymbol The returned symbol info.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param pMap The mapping record.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param hDbgMod The module handle.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param MapAddr The mapping address.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param iMapSeg The segment that's mapped, NIL_RTDBGSEGIDX or
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * RTDBGSEGIDX_RVA if the whole module is mapped here.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsyncDECLINLINE(void) rtDbgAsAdjustAddressByMapping(PRTUINTPTR pAddr, RTDBGSEGIDX iSeg,
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync RTDBGMOD hDbgMod, RTUINTPTR MapAddr, RTDBGSEGIDX iMapSeg)
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync RTUINTPTR SegRva = RTDbgModSegmentRva(hDbgMod, iMapSeg);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync AssertMsg(SegRva <= *pAddr, ("SegRva=%RTptr *pAddr=%RTptr\n", SegRva, *pAddr));
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync RTUINTPTR SegRva = RTDbgModSegmentRva(hDbgMod, iSeg);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * Adjusts the symbol value to correspond to the mapping of the module/segment.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param pSymbol The returned symbol info.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param hDbgMod The module handle.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param MapAddr The mapping address.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param iMapSeg The segment that's mapped, NIL_RTDBGSEGIDX if the
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * whole module is mapped here.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsyncDECLINLINE(void) rtDbgAsAdjustSymbolValue(PRTDBGSYMBOL pSymbol, RTDBGMOD hDbgMod, RTUINTPTR MapAddr, RTDBGSEGIDX iMapSeg)
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync rtDbgAsAdjustAddressByMapping(&pSymbol->Value, pSymbol->iSeg, hDbgMod, MapAddr, iMapSeg);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * Adjusts the line number address to correspond to the mapping of the module/segment.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param pLine The returned line number info.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param hDbgMod The module handle.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param MapAddr The mapping address.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param iMapSeg The segment that's mapped, NIL_RTDBGSEGIDX if the
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * whole module is mapped here.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsyncDECLINLINE(void) rtDbgAsAdjustLineAddress(PRTDBGLINE pLine, RTDBGMOD hDbgMod, RTUINTPTR MapAddr, RTDBGSEGIDX iMapSeg)
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync rtDbgAsAdjustAddressByMapping(&pLine->Address, pLine->iSeg, hDbgMod, MapAddr, iMapSeg);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Adds a symbol to a module in the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code. See RTDbgModSymbolAdd for more specific ones.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_INVALID_HANDLE if hDbgAs is invalid.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_NOT_FOUND if no module was found at the specified address.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @retval VERR_NOT_SUPPORTED if the module interpret doesn't support adding
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * custom symbols.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pszSymbol The symbol name.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param Addr The address of the symbol.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param cb The size of the symbol.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param fFlags Symbol flags.
044af0d1e6474076366759db86f101778c5f20ccvboxsyncRTDECL(int) RTDbgAsSymbolAdd(RTDBGAS hDbgAs, const char *pszSymbol, RTUINTPTR Addr, RTUINTPTR cb, uint32_t fFlags, uint32_t *piOrdinal)
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Validate input and resolve the address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync RTDBGMOD hMod = rtDbgAsModuleByAddr(pDbgAs, Addr, &iSeg, &offSeg, NULL);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Forward the call.
044af0d1e6474076366759db86f101778c5f20ccvboxsync int rc = RTDbgModSymbolAdd(hMod, pszSymbol, iSeg, offSeg, cb, fFlags, piOrdinal);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Query a symbol by address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code. See RTDbgModSymbolAddr for more specific ones.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_INVALID_HANDLE if hDbgAs is invalid.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_NOT_FOUND if the address couldn't be mapped to a module.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param Addr The address which closest symbol is requested.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param poffDisp Where to return the distance between the symbol
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * and address. Optional.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pSymbol Where to return the symbol info.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsSymbolByAddr(RTDBGAS hDbgAs, RTUINTPTR Addr, PRTINTPTR poffDisp, PRTDBGSYMBOL pSymbol)
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Validate input and resolve the address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync RTDBGMOD hMod = rtDbgAsModuleByAddr(pDbgAs, Addr, &iSeg, &offSeg, &MapAddr);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Forward the call.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync int rc = RTDbgModSymbolByAddr(hMod, iSeg, offSeg, poffDisp, pSymbol);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync rtDbgAsAdjustSymbolValue(pSymbol, hMod, MapAddr, iSeg);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Query a symbol by address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code. See RTDbgModSymbolAddrA for more specific ones.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_INVALID_HANDLE if hDbgAs is invalid.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_NOT_FOUND if the address couldn't be mapped to a module.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param Addr The address which closest symbol is requested.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param poffDisp Where to return the distance between the symbol
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * and address. Optional.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param ppSymbol Where to return the pointer to the allocated
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * symbol info. Always set. Free with RTDbgSymbolFree.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsSymbolByAddrA(RTDBGAS hDbgAs, RTUINTPTR Addr, PRTINTPTR poffDisp, PRTDBGSYMBOL *ppSymbol)
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Validate input and resolve the address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync RTDBGMOD hMod = rtDbgAsModuleByAddr(pDbgAs, Addr, &iSeg, &offSeg, &MapAddr);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Forward the call.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync int rc = RTDbgModSymbolByAddrA(hMod, iSeg, offSeg, poffDisp, ppSymbol);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync rtDbgAsAdjustSymbolValue(*ppSymbol, hMod, MapAddr, iSeg);
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Creates a snapshot of the module table on the temporary heap.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * The caller must release all the module handles before freeing the table
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * using RTMemTmpFree.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @returns Module table snaphot.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param pDbgAs The address space instance data.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param pcModules Where to return the number of modules.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsyncDECLINLINE(PRTDBGMOD) rtDbgAsSnapshotModuleTable(PRTDBGASINT pDbgAs, uint32_t *pcModules)
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync PRTDBGMOD paModules = (PRTDBGMOD)RTMemTmpAlloc(sizeof(paModules[0]) * RT_MAX(iMod, 1));
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync while (iMod-- > 0)
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * Attempts to find a mapping of the specified symbol/module and
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * adjust it's Value field accordingly.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @returns true / false success indicator.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param pDbgAs The address space.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param hDbgMod The module handle.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param pSymbol The symbol info.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsyncstatic bool rtDbgAsFindMappingAndAdjustSymbolValue(PRTDBGASINT pDbgAs, RTDBGMOD hDbgMod, PRTDBGSYMBOL pSymbol)
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * Absolute segments needs no fixing.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync return true;
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * Lookup up the module by it's handle and iterate the mappings looking for one
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * that either encompasses the entire module or the segment in question.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync PRTDBGASMOD pMod = (PRTDBGASMOD)RTAvlPVGet(&pDbgAs->ModTree, hDbgMod);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync for (PRTDBGASMAP pMap = pMod->pMapHead; pMap; pMap = pMap->pNext)
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync /* Exact segment match or full-mapping. */
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync rtDbgAsAdjustSymbolValue(pSymbol, hDbgMod, MapAddr, iMapSeg);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync return true;
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync /* Symbol uses RVA and the mapping doesn't, see if it's in the mapped segment. */
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync RTUINTPTR SegRva = RTDbgModSegmentRva(hDbgMod, pMap->iSeg);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync RTUINTPTR cbSeg = RTDbgModSegmentSize(hDbgMod, pMap->iSeg);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync rtDbgAsAdjustSymbolValue(pSymbol, hDbgMod, MapAddr, iMapSeg);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync return true;
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync /* else: Unmapped while we were searching. */
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync return false;
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Query a symbol by name.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_SYMBOL_NOT_FOUND if not found.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pszSymbol The symbol name.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pSymbol Where to return the symbol info.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsSymbolByName(RTDBGAS hDbgAs, const char *pszSymbol, PRTDBGSYMBOL pSymbol)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Iterate the modules, looking for the symbol.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync PRTDBGMOD paModules = rtDbgAsSnapshotModuleTable(pDbgAs, &cModules);
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync int rc = RTDbgModSymbolByName(paModules[i], pszSymbol, pSymbol);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync if (rtDbgAsFindMappingAndAdjustSymbolValue(pDbgAs, paModules[i], pSymbol))
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync for (; i < cModules; i++)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Query a symbol by name.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_SYMBOL_NOT_FOUND if not found.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pszSymbol The symbol name.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param ppSymbol Where to return the pointer to the allocated
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * symbol info. Always set. Free with RTDbgSymbolFree.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsSymbolByNameA(RTDBGAS hDbgAs, const char *pszSymbol, PRTDBGSYMBOL *ppSymbol)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Iterate the modules, looking for the symbol.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync PRTDBGMOD paModules = rtDbgAsSnapshotModuleTable(pDbgAs, &cModules);
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync int rc = RTDbgModSymbolByNameA(paModules[i], pszSymbol, ppSymbol);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync if (rtDbgAsFindMappingAndAdjustSymbolValue(pDbgAs, paModules[i], *ppSymbol))
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync for (; i < cModules; i++)
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * Adds a line number to a module in the address space.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @returns IPRT status code. See RTDbgModSymbolAdd for more specific ones.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @retval VERR_INVALID_HANDLE if hDbgAs is invalid.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @retval VERR_NOT_FOUND if no module was found at the specified address.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @retval VERR_NOT_SUPPORTED if the module interpret doesn't support adding
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * custom symbols.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param hDbgAs The address space handle.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param pszFile The file name.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param uLineNo The line number.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param Addr The address of the symbol.
044af0d1e6474076366759db86f101778c5f20ccvboxsync * @param piOrdinal Where to return the line number ordinal on success.
044af0d1e6474076366759db86f101778c5f20ccvboxsync * If the interpreter doesn't do ordinals, this will be
044af0d1e6474076366759db86f101778c5f20ccvboxsync * set to UINT32_MAX. Optional.
044af0d1e6474076366759db86f101778c5f20ccvboxsyncRTDECL(int) RTDbgAsLineAdd(RTDBGAS hDbgAs, const char *pszFile, uint32_t uLineNo, RTUINTPTR Addr, uint32_t *piOrdinal)
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * Validate input and resolve the address.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync RTDBGMOD hMod = rtDbgAsModuleByAddr(pDbgAs, Addr, &iSeg, &offSeg, NULL);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * Forward the call.
044af0d1e6474076366759db86f101778c5f20ccvboxsync int rc = RTDbgModLineAdd(hMod, pszFile, uLineNo, iSeg, offSeg, piOrdinal);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Query a line number by address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code. See RTDbgModSymbolAddrA for more specific ones.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_INVALID_HANDLE if hDbgAs is invalid.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_NOT_FOUND if the address couldn't be mapped to a module.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param Addr The address which closest symbol is requested.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param poffDisp Where to return the distance between the line
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * number and address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pLine Where to return the line number information.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsLineByAddr(RTDBGAS hDbgAs, RTUINTPTR Addr, PRTINTPTR poffDisp, PRTDBGLINE pLine)
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Validate input and resolve the address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync RTDBGMOD hMod = rtDbgAsModuleByAddr(pDbgAs, Addr, &iSeg, &offSeg, &MapAddr);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Forward the call.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync int rc = RTDbgModLineByAddr(hMod, iSeg, offSeg, poffDisp, pLine);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync rtDbgAsAdjustLineAddress(pLine, hMod, MapAddr, iSeg);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Query a line number by address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code. See RTDbgModSymbolAddrA for more specific ones.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_INVALID_HANDLE if hDbgAs is invalid.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_NOT_FOUND if the address couldn't be mapped to a module.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param Addr The address which closest symbol is requested.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param poffDisp Where to return the distance between the line
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * number and address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param ppLine Where to return the pointer to the allocated line
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * number info. Always set. Free with RTDbgLineFree.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsLineByAddrA(RTDBGAS hDbgAs, RTUINTPTR Addr, PRTINTPTR poffDisp, PRTDBGLINE *ppLine)
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Validate input and resolve the address.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync RTDBGMOD hMod = rtDbgAsModuleByAddr(pDbgAs, Addr, &iSeg, &offSeg, &MapAddr);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Forward the call.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync int rc = RTDbgModLineByAddrA(hMod, iSeg, offSeg, poffDisp, ppLine);