dbgas.cpp revision 172ae196da38208e5f1e3485715a89f2d53c6880
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.
aa4bcf0a4b2db3ac352b56a291d49cb8d4b66d32vboxsync/*******************************************************************************
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. */
8df047381fb076540a191d281498b66ba9182dbdvboxsync * 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). */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** The number of reference to this address space. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Handle of the read-write lock. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** Number of modules in the module address space. */
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync /** Pointer to the module table.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * The valid array length is given by cModules. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** AVL tree translating module handles to module entries. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync /** AVL tree mapping addresses to modules. */
8df047381fb076540a191d281498b66ba9182dbdvboxsync /** 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*******************************************************************************/
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync/** Validates an address space handle and returns rc if not valid. */
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync AssertReturn((pDbgAs)->u32Magic == RTDBGAS_MAGIC, (rc)); \
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync } while (0)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync/** 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); \
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync } while (0)
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync/*******************************************************************************
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync* Internal Functions *
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync*******************************************************************************/
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncstatic void rtDbgAsModuleUnlinkMod(PRTDBGASINT pDbgAs, PRTDBGASMOD pMod);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncstatic 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. */
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Variant of RTDbgAsCreate that takes a name format string.
aa4bcf0a4b2db3ac352b56a291d49cb8d4b66d32vboxsync * @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.
aa4bcf0a4b2db3ac352b56a291d49cb8d4b66d32vboxsync * @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.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @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);
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync RTStrSpaceDestroy(&pDbgAs->NameSpace, rtDbgAsDestroyNameCallback, NULL);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync while (i-- > 0)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDbgModRelease((RTDBGMOD)pDbgAs->paModules[i].Core.Key);
8df047381fb076540a191d281498b66ba9182dbdvboxsync * Retains another reference to the address space.
8df047381fb076540a191d281498b66ba9182dbdvboxsync * @returns New reference count, UINT32_MAX on invalid handle (asserted).
8df047381fb076540a191d281498b66ba9182dbdvboxsync * @param hDbgAs The address space handle.
8df047381fb076540a191d281498b66ba9182dbdvboxsync * @remarks Will not take any locks.
172ae196da38208e5f1e3485715a89f2d53c6880vboxsync * 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.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Gets the name of an address space.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @returns read only address space name.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * NULL if hDbgAs is invalid.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @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.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @remarks Will not take any locks.
aa4bcf0a4b2db3ac352b56a291d49cb8d4b66d32vboxsync * 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.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @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.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param fFlags See RTDBGASLINK_FLAGS_*.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @remarks The caller must have locked the address space for writing.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsyncint rtDbgAsModuleLinkCommon(PRTDBGASINT pDbgAs, RTDBGMOD hDbgMod, RTDBGSEGIDX iSeg,
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTUINTPTR Addr, RTUINTPTR cb, const char *pszName, uint32_t fFlags)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Check that the requested space is undisputed.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASMAP pAdjMod = (PRTDBGASMAP)RTAvlrUIntPtrGetBestFit(&pDbgAs->MapTree, Addr, false /* fAbove */);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync pAdjMod = (PRTDBGASMAP)RTAvlrUIntPtrGetBestFit(&pDbgAs->MapTree, Addr, true /* fAbove */);
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * First, create or find the module table entry.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync PRTDBGASMOD pMod = (PRTDBGASMOD)RTAvlPVGet(&pDbgAs->ModTree, hDbgMod);
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Ok, we need a new entry. Grow the table if necessary.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync 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);
8df047381fb076540a191d281498b66ba9182dbdvboxsync pName = (PRTDBGASNAME)RTMemAlloc(sizeof(*pName) + cchName + 1);
8df047381fb076540a191d281498b66ba9182dbdvboxsync 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));
8df047381fb076540a191d281498b66ba9182dbdvboxsync 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.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param fFlags See RTDBGASLINK_FLAGS_*.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsModuleLink(RTDBGAS hDbgAs, RTDBGMOD hDbgMod, RTUINTPTR ImageAddr, uint32_t fFlags)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync AssertReturn(!(fFlags & ~RTDBGASLINK_FLAGS_VALID_MASK), VERR_INVALID_PARAMETER);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Invoke worker common with RTDbgAsModuleLinkSeg.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync 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.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param fFlags See RTDBGASLINK_FLAGS_*.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(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);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync AssertReturn(!(fFlags & ~RTDBGASLINK_FLAGS_VALID_MASK), VERR_INVALID_PARAMETER);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Invoke worker common with RTDbgAsModuleLinkSeg.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync int rc = rtDbgAsModuleLinkCommon(pDbgAs, hDbgMod, iSeg, SegAddr, cb, pszName, fFlags);
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Worker for RTDbgAsModuleUnlink, RTDbgAsModuleUnlinkByAddr and rtDbgAsModuleLinkCommon.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pDbgAs Pointer to the address space instance data.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pMod The module to unlink.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @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)
aa4bcf0a4b2db3ac352b56a291d49cb8d4b66d32vboxsync * 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.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @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)
8df047381fb076540a191d281498b66ba9182dbdvboxsync /* free it */
8df047381fb076540a191d281498b66ba9182dbdvboxsync * Worker for RTDbgAsModuleUnlinkByAddr and rtDbgAsModuleLinkCommon that
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * unlinks a single mapping and releases the module if it's the last one.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pDbgAs The address space instance.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pMap The mapping to unlink.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @remarks The caller must have locked the address space for writing.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncstatic void rtDbgAsModuleUnlinkByMap(PRTDBGASINT pDbgAs, PRTDBGASMAP pMap)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Unlink it from the address space.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * 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.
77b92045ecae7978726dd23cb3d5de4676aec1c9vboxsync * @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.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Unlinks the mapping at the specified address.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @returns IPRT status code.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @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);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Hand it to
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Get a the handle of a module in the address space by is index.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @returns A retained handle to the specified module. The caller must release
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * the returned reference.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * NIL_RTDBGMOD if invalid index or handle.
aa4bcf0a4b2db3ac352b56a291d49cb8d4b66d32vboxsync * @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.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Get, retain and return it.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGMOD hMod = (RTDBGMOD)pDbgAs->paModules[iModule].Core.Key;
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Queries mapping module information by handle.
aa4bcf0a4b2db3ac352b56a291d49cb8d4b66d32vboxsync * @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);
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * 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.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync PRTDBGASNAME pName = (PRTDBGASNAME)RTStrSpaceGet(&pDbgAs->NameSpace, pszName);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync while (iName-- > 0)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Get, retain and return it.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Internal worker that looks up and retains a module.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns Module handle, NIL_RTDBGMOD if not found.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pDbgAs The address space instance data.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param Addr Address within the module.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param piSeg where to return the segment index.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param poffSeg Where to return the segment offset.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncDECLINLINE(RTDBGMOD) rtDbgAsModuleByAddr(PRTDBGASINT pDbgAs, RTUINTPTR Addr, PRTDBGSEGIDX piSeg, PRTUINTPTR poffSeg)
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGASMAP pMap = (PRTDBGASMAP)RTAvlrUIntPtrRangeGet(&pDbgAs->MapTree, Addr);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Adds a symbol to a module in the address space.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @returns IPRT status code. See RTDbgModSymbolAdd for more specific ones.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @retval VERR_INVALID_HANDLE if hDbgAs is invalid.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @retval VERR_NOT_FOUND if no module was found at the specified address.
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.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsyncRTDECL(int) RTDbgAsSymbolAdd(RTDBGAS hDbgAs, const char *pszSymbol, RTUINTPTR Addr, uint32_t cb)
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Validate input and resolve the address.
aa4bcf0a4b2db3ac352b56a291d49cb8d4b66d32vboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync RTDBGMOD hMod = rtDbgAsModuleByAddr(pDbgAs, Addr, &iSeg, &offSeg);
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Forward the call.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync int rc = RTDbgModSymbolAdd(hMod, pszSymbol, iSeg, offSeg, cb);
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Query a symbol by address.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @returns IPRT status code. See RTDbgModSymbolAddr for more specific ones.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @retval VERR_INVALID_HANDLE if hDbgAs is invalid.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @retval VERR_NOT_FOUND if the address couldn't be mapped to a module.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param hDbgAs The address space handle.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param Addr The address which closest symbol is requested.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param poffDisp Where to return the distance between the symbol
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * and address. Optional.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param pSymbol Where to return the symbol info.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsyncRTDECL(int) RTDbgAsSymbolByAddr(RTDBGAS hDbgAs, RTUINTPTR Addr, PRTINTPTR poffDisp, PRTDBGSYMBOL pSymbol)
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Validate input and resolve the address.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync RTDBGMOD hMod = rtDbgAsModuleByAddr(pDbgAs, Addr, &iSeg, &offSeg);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * Forward the call.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync int rc = RTDbgModSymbolByAddr(hMod, iSeg, offSeg, poffDisp, pSymbol);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * Query a symbol by address.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @returns IPRT status code. See RTDbgModSymbolAddrA for more specific ones.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @retval VERR_INVALID_HANDLE if hDbgAs is invalid.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @retval VERR_NOT_FOUND if the address couldn't be mapped to a module.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param hDbgAs The address space handle.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param Addr The address which closest symbol is requested.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param poffDisp Where to return the distance between the symbol
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * and address. Optional.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param ppSymbol Where to return the pointer to the allocated
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * symbol info. Always set. Free with RTDbgSymbolFree.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsyncRTDECL(int) RTDbgAsSymbolByAddrA(RTDBGAS hDbgAs, RTUINTPTR Addr, PRTINTPTR poffDisp, PRTDBGSYMBOL *ppSymbol)
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * Validate input and resolve the address.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync RTDBGMOD hMod = rtDbgAsModuleByAddr(pDbgAs, Addr, &iSeg, &offSeg);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * Forward the call.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync int rc = RTDbgModSymbolByAddrA(hMod, iSeg, offSeg, poffDisp, ppSymbol);
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * Creates a snapshot of the module table on the temporary heap.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * The caller must release all the module handles before freeing the table
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * using RTMemTmpFree.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @returns Module table snaphot.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param pDbgAs The address space instance data.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param pcModules Where to return the number of modules.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsyncDECLINLINE(PRTDBGMOD) rtDbgAsSnapshotModuleTable(PRTDBGASINT pDbgAs, uint32_t *pcModules)
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync PRTDBGMOD paModules = (PRTDBGMOD)RTMemTmpAlloc(sizeof(paModules[0]) * RT_MAX(iMod, 1));
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync while (iMod-- > 0)
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * 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.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @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.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Iterate the modules, looking for the symbol.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync PRTDBGMOD paModules = rtDbgAsSnapshotModuleTable(pDbgAs, &cModules);
aa4bcf0a4b2db3ac352b56a291d49cb8d4b66d32vboxsync int rc = RTDbgModSymbolByName(paModules[i], pszSymbol, pSymbol);
9d020a0622f95aec3aabaff436a495e88dbbd71avboxsync * Query a symbol by name.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @returns IPRT status code.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @retval VERR_SYMBOL_NOT_FOUND if not found.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param hDbgAs The address space handle.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * @param pszSymbol The symbol name.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param ppSymbol Where to return the pointer to the allocated
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * symbol info. Always set. Free with RTDbgSymbolFree.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsyncRTDECL(int) RTDbgAsSymbolByNameA(RTDBGAS hDbgAs, const char *pszSymbol, PRTDBGSYMBOL *ppSymbol)
9d020a0622f95aec3aabaff436a495e88dbbd71avboxsync * Validate input.
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Iterate the modules, looking for the symbol.
9d020a0622f95aec3aabaff436a495e88dbbd71avboxsync PRTDBGMOD paModules = rtDbgAsSnapshotModuleTable(pDbgAs, &cModules);
aa4bcf0a4b2db3ac352b56a291d49cb8d4b66d32vboxsync int rc = RTDbgModSymbolByNameA(paModules[i], pszSymbol, ppSymbol);
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.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @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.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param poffDisp Where to return the distance between the line
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * number and address.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsync * @param pLine Where to return the line number information.
ca3da10d05961c339b5180fbd40a54587d6bad35vboxsyncRTDECL(int) RTDbgAsLineByAddr(RTDBGAS hDbgAs, RTUINTPTR Addr, PRTINTPTR poffDisp, PRTDBGLINE pLine)
9d020a0622f95aec3aabaff436a495e88dbbd71avboxsync * Validate input and resolve the address.
9d020a0622f95aec3aabaff436a495e88dbbd71avboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync RTDBGMOD hMod = rtDbgAsModuleByAddr(pDbgAs, Addr, &iSeg, &offSeg);
9d020a0622f95aec3aabaff436a495e88dbbd71avboxsync * Forward the call.
9d020a0622f95aec3aabaff436a495e88dbbd71avboxsync int rc = RTDbgModLineByAddr(hMod, iSeg, offSeg, poffDisp, pLine);
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Query a line number by address.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @returns IPRT status code. See RTDbgModSymbolAddrA for more specific ones.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @retval VERR_INVALID_HANDLE if hDbgAs is invalid.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @retval VERR_NOT_FOUND if the address couldn't be mapped to a module.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param hDbgAs The address space handle.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param Addr The address which closest symbol is requested.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param poffDisp Where to return the distance between the line
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * number and address.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * @param ppLine Where to return the pointer to the allocated line
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * number info. Always set. Free with RTDbgLineFree.
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsyncRTDECL(int) RTDbgAsLineByAddrA(RTDBGAS hDbgAs, RTUINTPTR Addr, PRTINTPTR poffDisp, PRTDBGLINE *ppLine)
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync * Validate input and resolve the address.
8df047381fb076540a191d281498b66ba9182dbdvboxsync RTDBGAS_VALID_RETURN_RC(pDbgAs, VERR_INVALID_HANDLE);
9939c713bffcfc4305d99d994552aa2ad9bce097vboxsync RTDBGMOD hMod = rtDbgAsModuleByAddr(pDbgAs, Addr, &iSeg, &offSeg);
8b4a8db7768e94d025f1216ecfcd50d727fa2b7cvboxsync * Forward the call.